RFC 5525

Reliable Server Pooling MIB Module Definition

📅 published April 2009, from ietf

RFC 5525: Reliable Server Pooling MIB Module Definition 💖

okay bestie, let's start with the title block 🎀 This one came out in April 2009, written by T. Dreibholz from the University of Duisburg-Essen and J. Mulik from Delaware State University. It's Experimental, so it's a test-the-waters kind of doc, not an official Internet standard 🧪 And its header doesn't list anything it obsoletes or updates, so it's standing on its own ✨

Status of This Memo 📝

okay so this memo defines an Experimental Protocol for the Internet community 🧪 It does not specify an Internet standard of any kind, so don't go calling it official, periodt 💅 They're asking for discussion and suggestions for improvement, and distribution of this memo is unlimited 🌈

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 in effect on the date of publication of this document (http://trustee.ietf.org/license-info). Please review these documents carefully, as they describe your rights and restrictions with respect to this document. 📜 this part is lowkey important, so read it fr

Abstract 🦋

so Reliable Server Pooling (RSerPool) is a framework for providing reliable server pooling 💜 The RSerPool framework is made of two protocols: ASAP (Aggregate Server Access Protocol) and ENRP (Endpoint Handlespace Redundancy Protocol) ✨

This document defines an SMIv2-compliant (Structure of Management Information Version 2) Management Information Base (MIB) module that gives you access to managed objects in an RSerPool implementation 🌸 It's giving "dashboard for your server pool" energy 📊

Table of Contents 🗂️

1. Introduction ....................................................2
2. The Reliable Server Pooling (RSerPool) Framework ................2
3. Conventions .....................................................2
4. The Internet-Standard Management Framework ......................2
5. Structure of the MIB ............................................3
   5.1. Access to Managed Objects on ENRP Servers .................10
   5.2. Access to Managed Objects on Pool Elements ................10
   5.3. Access to Managed Objects on Pool Users ...................11
   5.4. Persistency Behavior ......................................11
6. Definitions ....................................................11
7. Operational Considerations .....................................42
8. Security Considerations ........................................42
9. IANA Considerations ............................................43
10. Acknowledgments ...............................................43
11. References ....................................................44
   11.1. Normative References .....................................44
   11.2. Informative References ...................................44

1. Introduction 🎀

okay so this memo defines a Management Information Base (MIB) module that describes managed objects for RSerPool implementations 🧚

2. The Reliable Server Pooling (RSerPool) Framework 🌊

if you want the full deep dive on the current RSerPool framework, go check out [RFC3237], [RFC5351], [RFC5352], [RFC5353], [RFC5354], [RFC5355], and [RFC5356] 📚 For a more casual intro, there's [RSerPoolPage] plus [Dre2006], [LCN2005], and [IJHIT2008] 🍓

3. Conventions 📏

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 [RFC2119] 🫶 these are the official BCP 14 vibes, so keep them in mind when you read ✨

4. The Internet-Standard Management Framework 🧠

if you want a detailed overview of the documents describing 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] 💜 And the textual conventions are compliant to RFC 4001 [RFC4001] 🌈

5. Structure of the MIB 🌳

the following diagram illustrates the structure of the MIB 👑

Structure of MIB

We're still inside Section 5 (the MIB structure), and now we're getting the full family tree of the tables. Think of it as a nested folder system: every table has rows, and every row has columns that hold the actual data. 🦋

The -R-- and -RW- bits tell you whether a column is readable only or readable and writable, and the Index lines show which keys pick out a specific row. 🧚

     |  |  |  |
     |  |  |  +--rserpoolENRPPoolElementEntry(1)
  +--rserpoolMIB(125)
     |
     +--rserpoolMIBObjects(1)
     |  |
     |  +--rserpoolENRPServers(1)
     |  |  |
     |  |  +--rserpoolENRPTable(1)
     |  |  |  |
     |  |  |  +--rserpoolENRPEntry(1)
     |  |  |     |  Index: rserpoolENRPIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolENRPIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- String    rserpoolENRPOperationScope(2)
     |  |  |     |        Textual Conv.: RSerPoolOperationScopeTC
     |  |  |     |        Size: 0..65535
     |  |  |     +-- -R-- Unsigned  rserpoolENRPIdentifier(3)
     |  |  |     |        Textual Conv.: RSerPoolENRPServerIdentifierTC
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -RW- String    rserpoolENRPDescription(4)
     |  |  |     |        Size: 0..255
     |  |  |     +-- -R-- TimeTicks rserpoolENRPUptime(5)
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPort(6)
     |  |  |     |        Textual Conv.: InetPortNumber
     |  |  |     |        Range: 0..65535
     |  |  |     +-- -R-- Unsigned  rserpoolENRPASAPAnnouncePort(7)
     |  |  |     |        Textual Conv.: InetPortNumber
     |  |  |     |        Range: 0..65535
     |  |  |     +-- -R-- EnumVal   rserpoolENRPASAPAnnounceAddrType(8)
     |  |  |     |        Textual Conv.: InetAddressType
     |  |  |     |        Values: ipv4(1), ipv6(2)
     |  |  |     +-- -R-- String    rserpoolENRPASAPAnnounceAddr(9)
     |  |  |     |        Textual Conv.: InetAddress
     |  |  |     |        Size: 4 | 16
     |  |  |     +-- -R-- Unsigned  rserpoolENRPENRPAnnouncePort(10)
     |  |  |     |        Textual Conv.: InetPortNumber
     |  |  |     |        Range: 0..65535
     |  |  |     +-- -R-- EnumVal   rserpoolENRPENRPAnnounceAddrType(11)
     |  |  |     |        Textual Conv.: InetAddressType
     |  |  |     |        Values: ipv4(1), ipv6(2)
     |  |  |     +-- -R-- String    rserpoolENRPENRPAnnounceAddr(12)
     |  |  |              Textual Conv.: InetAddress
     |  |  |              Size: 4 | 16
     |  |  |
     |  |  +--rserpoolENRPPoolTable(3)
     |  |  |  |
     |  |  |  +--rserpoolENRPPoolEntry(1)
     |  |  |     |  Index: rserpoolENRPIndex, rserpoolENRPPoolIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolENRPPoolIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- String    rserpoolENRPPoolHandle(2)
     |  |  |              Textual Conv.: RSerPoolPoolHandleTC
     |  |  |              Size: 0..65535
     |  |  |
     |  |  +--rserpoolENRPPoolElementTable(4)
     |  |  |  |
     |  |  |  +--rserpoolENRPPoolElementEntry(1)
     |  |  |     |  Index: rserpoolENRPIndex, rserpoolENRPPoolIndex,
     |  |  |     |         rserpoolENRPPoolElementIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolENRPPoolElementIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPoolElementID(2)
     |  |  |     |        Textual Conv.: RserpoolPoolElementIdentifierTC
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- Unsigned  rserpoolENRPASAPTransportPort(3)
     |  |  |     |        Textual Conv.: InetPortNumber
     |  |  |     |        Range: 0..65535
     |  |  |     +-- -R-- Unsigned  rserpoolENRPUserTransportProto(4)
     |  |  |     |        Range: 0..255
     |  |  |     +-- -R-- Unsigned  rserpoolENRPUserTransportPort(5)
     |  |  |     |        Textual Conv.: InetPortNumber
     |  |  |     |        Range: 0..65535
     |  |  |     +-- -R-- EnumVal   rserpoolENRPUserTransportUse(6)
     |  |  |     |        Textual Conv.: RSerPoolTransportUseTypeTC
     |  |  |     |        Values: dataOnly(0), dataPlusControl(1)
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPolicyID(7)
     |  |  |     |        Textual Conv.: RSerPoolPolicyIdentifierTC
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- String    rserpoolENRPPolicyDescription(8)
     |  |  |     |        Size: 0..255
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPolicyWeight(9)
     |  |  |     |        Textual Conv.: RSerPoolPolicyWeightTC
     |  |  |     |        Range: 0..4294967295
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPolicyLoad(10)
     |  |  |     |        Textual Conv.: RSerPoolPolicyLoadTC
     |  |  |     |        Range: 0..4294967295
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPolicyLoadDeg(11)
     |  |  |     |        Textual Conv.: RSerPoolPolicyLoadTC
     |  |  |     |        Range: 0..4294967295
     |  |  |     +-- -R-- TimeTicks rserpoolENRPRegistrationLife(12)
     |  |  |     +-- -R-- Unsigned  rserpoolENRPHomeENRPServer(13)
     |  |  |              Textual Conv.: RSerPoolENRPServerIdentifierTC
     |  |  |              Range: 1..4294967295
     |  |  |
     |  |  +--rserpoolENRPASAPAddrTable(5)
     |  |  |  |
     |  |  |  +--rserpoolENRPASAPAddrTableEntry(1)
     |  |  |     |  Index: rserpoolENRPIndex, rserpoolENRPPoolIndex,
     |  |  |     |         rserpoolENRPPoolElementIndex,
     |  |  |     |         rserpoolENRPASAPAddrTableIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolENRPASAPAddrTableIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- EnumVal   rserpoolENRPASAPL3Type(2)
     |  |  |     |        Textual Conv.: InetAddressType
     |  |  |     |        Values: ipv4(1), ipv6(2)
     |  |  |     +-- -R-- String    rserpoolENRPASAPL3Addr(3)
     |  |  |              Textual Conv.: InetAddress
     |  |  |              Size: 4 | 16
     |  |  |
     |  |  +--rserpoolENRPUserAddrTable(6)
     |  |  |  |
     |  |  |  +--rserpoolENRPUserAddrTableEntry(1)
     |  |  |     |  Index: rserpoolENRPIndex, rserpoolENRPPoolIndex,
     |  |  |     |         rserpoolENRPPoolElementIndex,
     |  |  |     |         rserpoolENRPUserAddrTableIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolENRPUserAddrTableIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- EnumVal   rserpoolENRPUserL3Type(2)
     |  |  |     |        Textual Conv.: InetAddressType
     |  |  |     |        Values: unknown(0), ipv4(1), ipv6(2)
     |  |  |     +-- -R-- String    rserpoolENRPUserL3Addr(3)
     |  |  |     |        Textual Conv.: InetAddress
     |  |  |     |        Size: 0 | 4 | 16
     |  |  |     +-- -R-- String    rserpoolENRPUserL3Opaque(4)
     |  |  |              Textual Conv.: RSerPoolOpaqueAddressTC
     |  |  |              Size: 0..65535
     |  |  |
     |  |  +--rserpoolENRPENRPAddrTable(7)
     |  |  |  |
     |  |  |  +--rserpoolENRPENRPAddrTableEntry(1)
     |  |  |     |  Index: rserpoolENRPIndex,
     |  |  |     |         rserpoolENRPENRPAddrTableIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolENRPENRPAddrTableIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- EnumVal   rserpoolENRPENRPL3Type(2)
     |  |  |     |        Textual Conv.: InetAddressType
     |  |  |     |        Values: ipv4(1), ipv6(2)
     |  |  |     +-- -R-- String    rserpoolENRPENRPL3Addr(3)
     |  |  |              Textual Conv.: InetAddress
     |  |  |              Size: 4 | 16
     |  |  |
     |  |  +--rserpoolENRPPeerTable(8)
     |  |  |  |
     |  |  |  +--rserpoolENRPPeerEntry(1)
     |  |  |     |  Index: rserpoolENRPPeerIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolENRPPeerIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPeerIdentifier(2)
     |  |  |     |        Textual Conv.: RSerPoolENRPServerIdentifierTC
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- Unsigned  rserpoolENRPPeerPort(3)
     |  |  |     |        Textual Conv.: 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 Conv.: InetAddressType
     |  |        |        Values: ipv4(1), ipv6(2)
     |  |        +-- -R-- String    rserpoolENRPPeerL3Addr(3)
     |  |                 Textual Conv.: InetAddress
     |  |                 Size: 4 | 16
     |  |
     |  +--rserpoolPoolElements(2)
     |  |  |
     |  |  +--rserpoolPETable(1)
     |  |  |  |
     |  |  |  +--rserpoolPEEntry(1)
     |  |  |     |  Index: rserpoolPEIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolPEIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- String    rserpoolPEOperationScope(2)
     |  |  |     |        Textual Conv.: RSerPoolOperationScopeTC
     |  |  |     |        Size: 0..65535
     |  |  |     +-- -RW- String    rserpoolPEPoolHandle(3)
     |  |  |     |        Textual Conv.: RSerPoolPoolHandleTC
     |  |  |     |        Size: 0..65535
     |  |  |     +-- -R-- Unsigned  rserpoolPEIdentifier(4)
     |  |  |     |        Textual Conv.: RserpoolPoolElementIdentifierTC
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -RW- String    rserpoolPEDescription(5)
     |  |  |     |        Size: 0..255
     |  |  |     +-- -R-- TimeTicks rserpoolPEUptime(6)
     |  |  |     +-- -R-- Unsigned  rserpoolPEASAPTransportPort(7)
     |  |  |     |        Textual Conv.: InetPortNumber
     |  |  |     |        Range: 0..65535
     |  |  |     +-- -R-- Unsigned  rserpoolPEUserTransportProto(8)
     |  |  |     |        Range: 0..255
     |  |  |     +-- -R-- Unsigned  rserpoolPEUserTransportPort(9)
     |  |  |     |        Textual Conv.: InetPortNumber
     |  |  |     |        Range: 0..65535
     |  |  |     +-- -R-- EnumVal   rserpoolPEUserTransportUse(10)
     |  |  |     |        Textual Conv.: RSerPoolTransportUseTypeTC
     |  |  |     |        Values: dataOnly(0), dataPlusControl(1)
     |  |  |     +-- -RW- Unsigned  rserpoolPEPolicyID(11)
     |  |  |     |        Textual Conv.: RSerPoolPolicyIdentifierTC
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -RW- String    rserpoolPEPolicyDescription(12)
     |  |  |     |        Size: 0..255
     |  |  |     +-- -RW- Unsigned  rserpoolPEPolicyWeight(13)
     |  |  |     |        Textual Conv.: RSerPoolPolicyWeightTC
     |  |  |     |        Range: 0..4294967295
     |  |  |     +-- -R-- Unsigned  rserpoolPEPolicyLoad(14)
     |  |  |     |        Textual Conv.: RSerPoolPolicyLoadTC
     |  |  |     |        Range: 0..4294967295
     |  |  |     +-- -RW- Unsigned  rserpoolPEPolicyLoadDeg(15)
     |  |  |     |        Textual Conv.: RSerPoolPolicyLoadTC
     |  |  |     |        Range: 0..4294967295
     |  |  |     +-- -RW- TimeTicks rserpoolPERegistrationLife(16)
     |  |  |     +-- -R-- Unsigned  rserpoolPEHomeENRPServer(17)
     |  |  |              Textual Conv.: RSerPoolENRPServerIdentifierTC
     |  |  |              Range: 1..4294967295
     |  |  |
     |  |  +--rserpoolPEASAPAddrTable(2)
     |  |  |  |
     |  |  |  +--rserpoolPEASAPAddrTableEntry(1)
     |  |  |     |  Index: rserpoolPEIndex, rserpoolPEASAPAddrTableIndex
     |  |  |     |
     |  |  |     +-- ---- Unsigned  rserpoolPEASAPAddrTableIndex(1)
     |  |  |     |        Range: 1..4294967295
     |  |  |     +-- -R-- EnumVal   rserpoolPEASAPL3Type(2)
     |  |  |     |        Textual Conv.: InetAddressType
     |  |  |     |        Values: ipv4(1), ipv6(2)
     |  |  |     +-- -R-- String    rserpoolPEASAPL3Addr(3)
     |  |  |              Textual Conv.: InetAddress
     |  |  |              Size: 4 | 16
     |  |  |
     |  |  +--rserpoolPEUserAddrTable(6)
     |  |     |
     |  |     +--rserpoolPEUserAddrTableEntry(1)
     |  |        |  Index: rserpoolPEIndex, rserpoolPEUserAddrTableIndex
     |  |        |
     |  |        +-- ---- Unsigned  rserpoolPEUserAddrTableIndex(1)
     |  |        |        Range: 1..4294967295
     |  |        +-- -R-- EnumVal   rserpoolPEUserL3Type(2)
     |  |        |        Textual Conv.: InetAddressType
     |  |        |        Values: unknown(0), ipv4(1), ipv6(2)
     |  |        +-- -R-- String    rserpoolPEUserL3Addr(3)
     |  |        |        Textual Conv.: InetAddress
     |  |        |        Size: 0 | 4 | 16
     |  |        +-- -R-- String    rserpoolPEUserL3Opaque(4)
     |  |                 Textual Conv.: RSerPoolOpaqueAddressTC
     |  |                 Size: 0..65535
     |  |
     |  +--rserpoolPoolUsers(3)
     |     |
     |     +--rserpoolPUTable(1)
     |        |
     |        +--rserpoolPUEntry(1)
     |           |  Index: rserpoolPUIndex
     |           |
     |           +-- ---- Unsigned  rserpoolPUIndex(1)
     |           |        Range: 1..4294967295
     |           +-- -R-- String    rserpoolPUOperationScope(2)
     |           |        Textual Conv.: RSerPoolOperationScopeTC
     |           |        Size: 0..65535
     |           +-- -RW- String    rserpoolPUPoolHandle(3)
     |           |        Textual Conv.: RSerPoolPoolHandleTC
     |           |        Size: 0..65535
     |           +-- -RW- String    rserpoolPUDescription(4)
     |           |        Size: 0..255
     |           +-- -R-- TimeTicks rserpoolPUUptime(5)
     |
     +--rserpoolMIBConformance(2)
        |
        +--rserpoolMIBCompliances(1)
        |  |
        |  +--rserpoolMIBCompliance(1)
        |
        +--rserpoolMIBGroups(2)
           |
           +--rserpoolENRPGroup(1)
           +--rserpoolPEGroup(2)
           +--rserpoolPUGroup(3)

Okay, so the tree shows that the MIB has three main branches, and they're named rserpoolENRPServers, rserpoolPoolElements, and rserpoolPoolUsers 🌳✨. Let's break them down, bestie 💅.

The first branch, rserpoolENRPServers, is where you get to poke at the managed objects for the whole set of ENRP servers running on one host 🖥️. Honestly, it doesn't really make sense to run more than one ENRP server for the same operation scope on a single host 🙄. But running a bunch of ENRP servers for different operation scopes? Very likely, especially when the ENRP server processes live on routers 🛜. So the MIB has to be able to manage multiple ENRP servers on the same host, no cap 🔥.

rserpoolPoolElements is the branch for managed objects in the set of pool elements running on a given host 🧚.

The third branch, rserpoolPoolUsers, does the same job but for the pool users running on a given host 🫶.

Note: rserpoolENRPServers gets filled in on hosts running ENRP server instances, rserpoolPoolElements gets filled in on hosts running pool element instances, and rserpoolPoolUsers gets filled in on hosts running pool user instances 💜. Of course, multiple different components can run on the same host, which means you can end up filling in multiple different branches at once 🌈.

Now, the three branches are lowkey super similar to each other 👯. So we only go into full detail on the first one, and give the second and third a quick summary. Let's get into it 💖.

5.1. Access to Managed Objects on ENRP Servers

The first branch describes managed objects at a set of ENRP servers 🖥️. At any given moment, any ENRP server in that set has registration info for a bunch of active pools 🏊. Each of those pools can have a list of pool elements registered under it 📋. To make all of this retrievable over 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, like this 👑:

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

5.2. Access to Managed Objects on Pool Elements

The Pool Elements branch is built pretty much the same way as the pool elements table in the ENRP servers branch 🧁. The twist is that here we don't group pool elements into pools (that would not make sense in this case 🙅). Instead, the pool elements table sits at the very top of the hierarchy, and each pool element entry says what its operation scope and pool handle are 🎀.

So the nesting structure looks like this:

Nesting of the Pool Elements Branch

 Level 1:    rserpoolPETable
 Level 2:       rserpoolPEASAPAddrTable
                rserpoolPEUserAddrTable

5.3. Access to Managed Objects on Pool Users

For the Pool Users branch, all we really need to do is list the pool user instances, including their operation scope and pool handle 🦋.

5.4. Persistency Behavior

When writable objects change, an implementation SHOULD store the new values persistently, as long as it has the capability to do that 💾. And an implementation SHOULD use those stored values when it gets reset or reinitialized 🔄. Keep those values safe, bestie 🫶.

6. Definitions ✨

The MIB module itself lives below 👇.

RSERPOOL-MIB DEFINITIONS ::= BEGIN

IMPORTS
   MODULE-IDENTITY, OBJECT-TYPE, experimental,
   TimeTicks, Unsigned32
      FROM SNMPv2-SMI
   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
      "200904070000Z" -- April 07, 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.

          Copyright (c) 2009 IETF Trust and the persons identified as
          authors of the code.  All rights reserved.

          Redistribution and use in source and binary forms, with or
          without modification, are permitted provided that the
          following conditions are met:

          - Redistributions of source code must retain the above
            copyright notice, this list of conditions and the
            following disclaimer.

          - Redistributions in binary form must reproduce the above
            copyright notice, this list of conditions and the
            following disclaimer in the documentation and/or other
            materials provided with the distribution.

          - Neither the name of Internet Society, IETF or IETF Trust,
            nor the names of specific contributors, may be used to
            endorse or promote products derived from this software
            without specific prior written permission.

          THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
          CONTRIBUTORS 'AS IS' AND ANY EXPRESS OR IMPLIED WARRANTIES,
          INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
          MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
          DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR
          CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
          SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
          NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
          LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
          HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
          CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
          OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
          SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
          DAMAGE.

          This version of this MIB module is part of RFC 5525;
          see the RFC itself for full legal notices."

      REVISION
         "200904070000Z" -- April 07, 2009
      DESCRIPTION
         "This version of the MIB module is published as RFC 5525"
      ::= { experimental 125 }

-- ## RSerPool type definitions ###################################
RSerPoolENRPServerIdentifierTC ::= TEXTUAL-CONVENTION
   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))

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
   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 }

Okay so this next bit is the ENRP server table entry, and it's giving full catalogue of everything the server knows about itself 💖🧚

RserpoolENRPEntry ::= SEQUENCE {
rserpoolENRPIndex                Unsigned32,
rserpoolENRPOperationScope       RSerPoolOperationScopeTC,
rserpoolENRPIdentifier           RSerPoolENRPServerIdentifierTC,
rserpoolENRPDescription          OCTET STRING,
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."
   REFERENCE
      "Section 1.2 of RFC 3237 defines the term operation scope."
   ::= { rserpoolENRPEntry 2 }

rserpoolENRPIdentifier OBJECT-TYPE
   SYNTAX     RSerPoolENRPServerIdentifierTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The ENRP server identifier of this ENRP server."
   REFERENCE
      "Section 3.1 of RFC 5351 explains the ENRP server identifier."
   ::= { rserpoolENRPEntry 3 }

rserpoolENRPDescription OBJECT-TYPE
   SYNTAX     OCTET STRING (SIZE (0..255))
   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.

      This object SHOULD be maintained in a persistent manner."
   ::= { rserpoolENRPEntry 4 }

rserpoolENRPUptime OBJECT-TYPE
   SYNTAX     TimeTicks
   MAX-ACCESS read-only
   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 Stream Control Transmission Protocol (SCTP) port number of
      the ENRP protocol endpoint of this ENRP server."
   REFERENCE
      "RFC 5353 defines the ENRP protocol."
   ::= { rserpoolENRPEntry 6 }

rserpoolENRPASAPAnnouncePort OBJECT-TYPE
   SYNTAX     InetPortNumber
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The destination UDP port number to which ASAP multicast announce
      messages are sent."
   REFERENCE
      "Section 3.2 of RFC 5351 explains the server-discovery mechanism
      using ASAP announces."
   ::= { rserpoolENRPEntry 7 }

rserpoolENRPASAPAnnounceAddrType OBJECT-TYPE
   SYNTAX     InetAddressType { ipv4(1), ipv6(2) }
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The network-layer protocol over which ASAP multicast announce
      messages are sent."
   REFERENCE
      "Section 3.2 of RFC 5351 explains the server-discovery mechanism
      using ASAP announces."
   ::= { rserpoolENRPEntry 8 }

rserpoolENRPASAPAnnounceAddr OBJECT-TYPE
   SYNTAX     InetAddress (SIZE(4|16))
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The destination IP multicast address to which ASAP multicast
      announce messages are sent.  The type of this address is
      given in rserpoolENRPASAPAnnounceAddrType."
   REFERENCE
      "Section 3.2 of RFC 5351 explains the server-discovery mechanism
      using ASAP announces."
   ::= { rserpoolENRPEntry 9 }

rserpoolENRPENRPAnnouncePort OBJECT-TYPE
   SYNTAX     InetPortNumber
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The destination UDP port number to which ENRP multicast announce
      messages are sent."
   REFERENCE
      "Section 3.1 of RFC 5353 explains the ENRP multicast
      announce mechanism."
   ::= { rserpoolENRPEntry 10 }

rserpoolENRPENRPAnnounceAddrType OBJECT-TYPE
   SYNTAX     InetAddressType { ipv4(1), ipv6(2) }
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The network-layer protocol over which ENRP multicast announce
      messages are sent."
   REFERENCE
      "Section 3.1 of RFC 5353 explains the ENRP multicast
      announce mechanism."
   ::= { rserpoolENRPEntry 11 }

rserpoolENRPENRPAnnounceAddr OBJECT-TYPE
   SYNTAX     InetAddress (SIZE(4|16))
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The destination multicast IP address to which ENRP multicast
      announce messages are sent.  The type of this address
      is given in rserpoolENRPENRPAnnounceAddrType."
   REFERENCE
      "Section 3.1 of RFC 5353 explains the ENRP multicast
      announce mechanism."
   ::= { rserpoolENRPEntry 12 }

Next up is the pool table, and it's a total glow-up: each pool gets its own little row, keyed by the server it lives under 🎀✨

-- ## 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)
   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."
   REFERENCE
      "Section 1.2 of RFC 3237 defines the term pool handle."

   ::= { rserpoolENRPPoolEntry 2 }

And last but definitely not least: the pool element table 🦋 this is where all the juicy per-member details live, like transport ports, policy stuff, and registration life 💅

-- ## 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  OCTET STRING,
   rserpoolENRPPolicyWeight       RSerPoolPolicyWeightTC,
   rserpoolENRPPolicyLoad         RSerPoolPolicyLoadTC,
   rserpoolENRPPolicyLoadDeg      RSerPoolPolicyLoadTC,
   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."
   REFERENCE
      "Section 2.2 of RFC 5351 explains the pool element identifier
      usage."
   ::={ 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the port number is given here."
   ::= { 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the transport protocol number is given here."
   ::= { 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."

   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the port number is given here."
   ::= { rserpoolENRPPoolElementEntry 5 }

rserpoolENRPUserTransportUse OBJECT-TYPE
   SYNTAX     RSerPoolTransportUseTypeTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The transport use of the service endpoint of this pool
      element."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the transport use is given here."
   ::= { rserpoolENRPPoolElementEntry 6 }

rserpoolENRPPolicyID OBJECT-TYPE
   SYNTAX     RSerPoolPolicyIdentifierTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The pool policy of this pool element."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy identifier is given here."
   ::= { rserpoolENRPPoolElementEntry 7 }

rserpoolENRPPolicyDescription OBJECT-TYPE
   SYNTAX     OCTET STRING (SIZE (0..255))
   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."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy's weight parameter is given here."
   ::= { rserpoolENRPPoolElementEntry 9 }

rserpoolENRPPolicyLoad OBJECT-TYPE
   SYNTAX     RSerPoolPolicyLoadTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The pool policy's load status for this pool element."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy's load parameter is given here."
   ::= { rserpoolENRPPoolElementEntry 10 }

rserpoolENRPPolicyLoadDeg OBJECT-TYPE
   SYNTAX     RSerPoolPolicyLoadTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The pool policy's load degradation parameter for this pool
      element."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy's load degradation parameter is
      given here."
   ::= { rserpoolENRPPoolElementEntry 11 }

rserpoolENRPRegistrationLife OBJECT-TYPE
   SYNTAX     TimeTicks
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The registration life of this pool element."
  REFERENCE
      "Section 3.10 of RFC 5354 defines the Registration Life."
   ::= { rserpoolENRPPoolElementEntry 12 }

okay so the next object is the home ENRP server one 💖 it just tells you which ENRP server is home for this pool element 🏠

rserpoolENRPHomeENRPServer OBJECT-TYPE
   SYNTAX     RSerPoolENRPServerIdentifierTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The ID of the Home ENRP server of this pool element."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the Home ENRP Server
      Identifier."
   ::= { rserpoolENRPPoolElementEntry 13 }

next up is the ASAP transport address list table 🦋 it's basically a whole list of every IP address the ASAP transport endpoint has, and each one gets its own row ✨

-- ## 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the addresses are listed in this table."
   ::= { rserpoolENRPServers 5 }

rserpoolENRPASAPAddrTableEntry  OBJECT-TYPE
   SYNTAX     RserpoolENRPASAPAddrTableEntry
   MAX-ACCESS not-accessible
   STATUS     current
   DESCRIPTION
      "An IP address of the ASAP transport endpoint."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which an address is contained by this entry."
   INDEX {
      rserpoolENRPIndex,
      rserpoolENRPPoolIndex,
      rserpoolENRPPoolElementIndex,
      rserpoolENRPASAPAddrTableIndex }
   ::= { rserpoolENRPASAPAddrTable 1 }

RserpoolENRPASAPAddrTableEntry ::= SEQUENCE {
   rserpoolENRPASAPAddrTableIndex Unsigned32,
   rserpoolENRPASAPL3Type         InetAddressType,
   rserpoolENRPASAPL3Addr         InetAddress }

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."
   REFERENCE

      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the network-layer protocol number is given here."
   ::= { 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the network-layer address (IPv4 or IPv6) is given here."
   ::= { rserpoolENRPASAPAddrTableEntry 3 }

now the user transport address list table 🌸 same vibe as the ASAP one, but this time it's for the user transport endpoint, and it has an extra opaque address column for when the address isn't a plain IP 🧚

-- ## 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the addresses are listed in this table."
   ::= { rserpoolENRPServers 6 }

rserpoolENRPUserAddrTableEntry  OBJECT-TYPE
   SYNTAX     RserpoolENRPUserAddrTableEntry
   MAX-ACCESS not-accessible
   STATUS     current
   DESCRIPTION
      "An IP address of the user transport endpoint."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which an address is contained by this entry."
   INDEX {
      rserpoolENRPIndex,
      rserpoolENRPPoolIndex,
      rserpoolENRPPoolElementIndex,
      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 a user transport
      endpoint."
   ::= { rserpoolENRPUserAddrTableEntry 1 }

rserpoolENRPUserL3Type OBJECT-TYPE
   SYNTAX     InetAddressType { unknown(0), ipv4(1), ipv6(2) }
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The network-layer protocol (IPv4 or IPv6) of an IP address
      of a user transport endpoint.  Set to unknown for an opaque
      address."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the network-layer protocol number is given here."
   ::= { rserpoolENRPUserAddrTableEntry 2 }

rserpoolENRPUserL3Addr OBJECT-TYPE
   SYNTAX     InetAddress (SIZE(0|4|16))
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The IP address of a user transport endpoint.  The type of
      this address is given in rserpoolENRPUserL3Type."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the network-layer address (IPv4 or IPv6) is given here."
   ::= { rserpoolENRPUserAddrTableEntry 3 }

rserpoolENRPUserL3Opaque OBJECT-TYPE
   SYNTAX     RSerPoolOpaqueAddressTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The opaque address of a user transport endpoint."
   REFERENCE
      "Section 3.16 of RFC 5354 defines the opaque transport address."
   ::= { rserpoolENRPUserAddrTableEntry 4 }

next is the ENRP address list table 🫶 this one lists every IP address of the ENRP transport endpoint, and the references point to RFC 5353 since that's the one that defines ENRP itself 📖

-- ## Definition of ENRP address list table #######################
rserpoolENRPENRPAddrTable OBJECT-TYPE
   SYNTAX     SEQUENCE OF RserpoolENRPENRPAddrTableEntry
   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."
   REFERENCE
      "RFC 5353 defines the ENRP protocol."
   ::= { 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."
   REFERENCE
      "RFC 5353 defines the ENRP protocol."
   ::= { rserpoolENRPENRPAddrTableEntry 3 }

now the peer table 👑 it keeps track of the peers, including their ENRP identifier, SCTP port, and how long ago their last ENRP Presence message showed up 🕰️

-- ## 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 RSerPoolENRPServerIdentifierTC,
   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     RSerPoolENRPServerIdentifierTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The ENRP identifier of this peer."
   REFERENCE
      "RFC 5353 explains the usage of the ENRP server identifier."
   ::= { rserpoolENRPPeerEntry 2 }

rserpoolENRPPeerPort OBJECT-TYPE
   SYNTAX     InetPortNumber
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The SCTP port number of the ENRP transport endpoint of
      this peer."
   REFERENCE
      "RFC 5353 defines the ENRP protocol."
   ::= { 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."
   REFERENCE
      "Section 4.1 of RFC 5353 defines the last heard value."
   ::= { rserpoolENRPPeerEntry 4 }

last bit of the peer stuff is the peer address list table 💜 it's the peer's ENRP transport endpoint addresses, one row per address, all pointing back to RFC 5353 for ENRP 🦋

-- ## 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 rserpoolENRPPeerIndex."
   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."
   ::= { 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."
   REFERENCE
      "RFC 5353 defines the ENRP protocol."
   ::= { 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."
   REFERENCE
      "RFC 5353 defines the ENRP protocol."
   ::= { rserpoolENRPPeerAddrTableEntry 3 }

and now we're on to the pool elements section 🎀 this is where the pool element table lives, so it's a whole new vibe ✨

-- ################################################################
-- #### 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 }

Okay bestie, this part is all about the pool element table 🧚✨ Every row is one pool element, and the index is how we find it. Heads up, rserpoolPEIndex is there because the pool element identifier isn't guaranteed unique in the pool, so the index is literally required 🙈

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,
   rserpoolPEIdentifier         RserpoolPoolElementIdentifierTC,
   rserpoolPEDescription        OCTET STRING,
   rserpoolPEUptime             TimeTicks,
   rserpoolPEASAPTransportPort  InetPortNumber,
   rserpoolPEUserTransportProto Unsigned32,
   rserpoolPEUserTransportPort  InetPortNumber,
   rserpoolPEUserTransportUse   RSerPoolTransportUseTypeTC,
   rserpoolPEPolicyID           RSerPoolPolicyIdentifierTC,
   rserpoolPEPolicyDescription  OCTET STRING,
   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."
   REFERENCE
      "Section 1.2 of RFC 3237 defines the term operation scope."
   ::= { 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.

      This object SHOULD be maintained in a persistent manner."
   REFERENCE
      "Section 1.2 of RFC 3237 defines the term pool handle."
   ::={ rserpoolPEEntry 3 }

rserpoolPEIdentifier OBJECT-TYPE
   SYNTAX     RserpoolPoolElementIdentifierTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The pool element identifier of this pool element."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the pool element identifier."
   ::={ rserpoolPEEntry 4 }

rserpoolPEDescription OBJECT-TYPE
   SYNTAX     OCTET STRING (SIZE (0..255))
   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.

      This object SHOULD be maintained in a persistent manner."
   ::= { 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the port number is given here."
   ::= { 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the transport protocol number is given here."
   ::= { 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the port number is given here."
   ::= { rserpoolPEEntry 9 }

rserpoolPEUserTransportUse OBJECT-TYPE
   SYNTAX     RSerPoolTransportUseTypeTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The transport use of the service endpoint of this pool element."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the transport use is given here."
   ::= { 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.

      This object SHOULD be maintained in a persistent manner."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy identifier is given here."
   ::= { rserpoolPEEntry 11 }

rserpoolPEPolicyDescription OBJECT-TYPE
   SYNTAX     OCTET STRING (SIZE (0..255))
   MAX-ACCESS read-write
   STATUS     current
   DESCRIPTION
      "The textual description of the pool policy of this pool element.

      This object SHOULD be maintained in a persistent manner."
   ::= { 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.

      This object SHOULD be maintained in a persistent manner."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy's weight parameter is given here."
   ::= { rserpoolPEEntry 13 }

rserpoolPEPolicyLoad OBJECT-TYPE
   SYNTAX     RSerPoolPolicyLoadTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The pool policy's load status for this pool element."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy's load parameter is given here."
   ::= { rserpoolPEEntry 14 }

rserpoolPEPolicyLoadDeg OBJECT-TYPE
   SYNTAX     RSerPoolPolicyLoadTC
   MAX-ACCESS read-write
   STATUS     current
   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.

      This object SHOULD be maintained in a persistent manner."
   REFERENCE
      "Section 3.8 of RFC 5354 defines the Member Selection Policy
      Parameter of which the policy's load degradation parameter is
      given here."
   ::= { 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.

      This object SHOULD be maintained in a persistent manner."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the Registration Life."
   ::= { 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the Home ENRP Server
      Identifier."
   ::= { rserpoolPEEntry 17 }

Next up is the ASAP transport address list, which is basically the list of every IP address the ASAP endpoint of a pool element can be reached on 🦋 This is the bit where the index combo does the heavy lifting: rserpoolPEIndex plus rserpoolPEASAPAddrTableIndex together identify one address row 💅

-- ## 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the addresses are listed in this table."
   ::= { rserpoolPoolElements 2 }

rserpoolPEASAPAddrTableEntry  OBJECT-TYPE
   SYNTAX     RserpoolPEASAPAddrTableEntry
   MAX-ACCESS not-accessible
   STATUS     current
   DESCRIPTION
      "An IP address of the ASAP transport endpoint."
  REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which an address is contained by this entry."
  INDEX {
      rserpoolPEIndex,
      rserpoolPEASAPAddrTableIndex }
   ::= { rserpoolPEASAPAddrTable 1 }

RserpoolPEASAPAddrTableEntry ::= SEQUENCE {
   rserpoolPEASAPAddrTableIndex Unsigned32,
   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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the network-layer protocol number is given here."
   ::= { 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of
      which the network-layer address (IPv4 or IPv6) is given here."
   ::= { rserpoolPEASAPAddrTableEntry 3 }

Last bit of this part is the user transport address list, same vibe but for the service endpoint instead of the ASAP one 🌸 Notice the extra rserpoolPEUserL3Opaque column in this table, which is the only real difference from the ASAP version 👀

-- ## 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."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the addresses are listed in this table."
   ::= { rserpoolPoolElements 6 }

rserpoolPEUserAddrTableEntry  OBJECT-TYPE
   SYNTAX     RserpoolPEUserAddrTableEntry
   MAX-ACCESS not-accessible
   STATUS     current
   DESCRIPTION
      "An IP address of the user transport endpoint."
  REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which an address is contained by this entry."
   INDEX {
      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 a user transport
      endpoint."
   ::= { rserpoolPEUserAddrTableEntry 1 }
rserpoolPEUserL3Type OBJECT-TYPE
   SYNTAX     InetAddressType { unknown(0), ipv4(1), ipv6(2) }
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The network-layer protocol of an IP address of a user transport
      endpoint.  Set to unknown for opaque address."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the network-layer protocol number is given here."
   ::= { rserpoolPEUserAddrTableEntry 2 }

rserpoolPEUserL3Addr OBJECT-TYPE
   SYNTAX     InetAddress (SIZE(0|4|16))
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The IP address of a user transport endpoint.  The type of
      this address is given in rserpoolPEUserL3Addr."
   REFERENCE
      "Section 3.10 of RFC 5354 defines the User Transport Parameter of
      which the network-layer address (IPv4 or IPv6) is given here."
   ::= { rserpoolPEUserAddrTableEntry 3 }

rserpoolPEUserL3Opaque OBJECT-TYPE
   SYNTAX     RSerPoolOpaqueAddressTC
   MAX-ACCESS read-only
   STATUS     current
   DESCRIPTION
      "The opaque address of a user transport endpoint."
   REFERENCE
      "Section 3.16 of RFC 5354 defines the opaque transport address."
   ::= { rserpoolPEUserAddrTableEntry 4 }

-- ################################################################
-- #### 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    OCTET STRING,
   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."
   REFERENCE
      "Section 1.2 of RFC 3237 defines the term operation scope."
   ::= { rserpoolPUEntry 2 }

rserpoolPUPoolHandle OBJECT-TYPE
   SYNTAX     RSerPoolPoolHandleTC
   MAX-ACCESS read-write
   STATUS     current
   DESCRIPTION
      "The pool handle of this pool user.  Changing this object
      will update the pool user's pool handle for all future
      sessions.

      This object SHOULD be maintained in a persistent manner."
   REFERENCE
      "Section 1.2 of RFC 3237 defines the term pool handle."
   ::={ rserpoolPUEntry 3 }

rserpoolPUDescription OBJECT-TYPE
   SYNTAX     OCTET STRING (SIZE (0..255))
   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.

      This object SHOULD be maintained in a persistent manner."
   ::= { 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 that implement
      RSerPool."
   MODULE
   MANDATORY-GROUPS {
      rserpoolENRPGroup,
      rserpoolPEGroup,
      rserpoolPUGroup }

   ::= { rserpoolMIBCompliances 1 }

rserpoolENRPGroup OBJECT-GROUP
   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 }

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

7. Operational Considerations 🛠️

okay so the RSerPool MIB sits on the Experimental track 🧪, because the RSerPool documents themselves are Experimental RFCs. it's giving consistency, bestie 💅

8. Security Considerations 🔒

okay this section is serious, so listen up 👀 there are a bunch of management objects in this MIB module with a MAX-ACCESS of read-write and/or read-create. those objects can be sensitive or vulnerable in some network environments. SET operations in a non-secure environment without proper protection can seriously mess with network operations 😭 these are the tables and objects and how sensitive or vulnerable they are:

  • rserpoolENRPDescription (textual description change)
  • rserpoolPEPoolHandle (pool handle of pool element change, similar to ASAP)
  • rserpoolPEDescription (textual description change)
  • rserpoolPEPolicyID (pool element ID change, similar to ASAP)
  • rserpoolPEPolicyDescription (textual description change)
  • rserpoolPEPolicyWeight (policy weight change, similar to ASAP)
  • rserpoolPEPolicyLoadDeg (policy load degradation change, similar to ASAP)
  • rserpoolPERegistrationLife (registration lifetime change, similar to ASAP)
  • rserpoolPUPoolHandle (pool handle of accessed pool change, similar to ASAP)
  • rserpoolPUDescription (textual description change)

the security stuff for changing these is basically the same as changing things through ASAP 🫶 the full breakdown lives in the threats doc [RFC5355]. and rewriting those textual descriptions can lead admins to make bad calls based on malicious info 🙈

some of the readable objects in this MIB module (the ones with a MAX-ACCESS other than not-accessible) can be sensitive or vulnerable too. it is super important to control even GET and/or NOTIFY access to them, and maybe even encrypt their values when they go over the network via SNMP 🔐 reading them reveals the same info you can already get through ASAP and ENRP access. the security implications of those two protocols are explained in detail in the threats doc [RFC5355].

SNMP versions before SNMPv3 did not have adequate security 💀 even if the network itself is secure (say, with IPsec), there is still no control over who on that secure network can GET and SET (read/change/create/delete) the objects in this MIB module. no thanks 🙅‍♀️

It is RECOMMENDED that implementers consider the security features provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy) 🔑

and then, deploying SNMP versions before SNMPv3 is NOT RECOMMENDED 🚫 instead, it is RECOMMENDED to deploy SNMPv3 and turn on cryptographic security. it's then the customer/operator's job to make sure the SNMP entity giving access to this MIB module is set up so only principals (users) with legit rights can GET or SET (change/create/delete) those objects 🧚

9. IANA Considerations 🌸

the MIB module in this document uses the following IANA-assigned OBJECT IDENTIFIER values, recorded in the SMI Numbers registry:

Descriptor OBJECT IDENTIFIER Value
----------  -----------------------
rserpoolMIB { experimental 125 }

10. Acknowledgments 🫶

the authors want to give a special shoutout to Phillip Conrad and Kevin Pinzhoffer for their work in the early formation of this document 👑 they also want to thank Bert Wijnen and Dan Romascanu for their valuable comments. and finally, a big thank you to Nihad Cosic, Dirk Hoffstadt, Michael Kohnen, Jobin Pulinthanath, Randall Stewart, Michael Tuexen, and Xing Zhou for their support 💖

11. References 📚

11.1. Normative References ✨

okay bestie, these are the docs the spec needs you to have read first. no cap, you can't skip them 📚

  • [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. 💅
  • [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. 🦋
  • [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. ⭐

11.2. Informative References 🌈

these ones are the extra reading. not required to build the thing, but iykyk, they're so worth it for the backstory 🫶

  • [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. 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, March 2007, <http://duepublico.uni-duisburg-essen.de/servlets/DerivateServlet/Derivate-16326/Dre2006-final.pdf>. 🎓
  • [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 Evaluation 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", <http://tdrwww.iem.uni-due.de/dreibholz/rserpool/>. 🌐
  • [SNMPMIBS] Perkins, D. and E. McGinnis, "Understanding SNMP MIBs", 1997. 📖

Authors' Addresses 💌

the people behind the paper, with their contact info so you can slide into their inbox if you have questions 🥰

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/


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
📦 where this page comes from