idnits 2.17.1 draft-ietf-rserpool-mib-12.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- ** The document seems to lack a License Notice according IETF Trust Provisions of 28 Dec 2009, Section 6.b.i or Provisions of 12 Sep 2009 Section 6.b -- however, there's a paragraph with a matching beginning. Boilerplate error? -- It seems you're using the 'non-IETF stream' Licence Notice instead Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** There are 67 instances of weird spacing in the document. Is it really formatted ragged-right, rather than justified? Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == Line 128 has weird spacing: '...nsigned rserp...' == Line 130 has weird spacing: '... String rse...' == Line 133 has weird spacing: '...nsigned rserp...' == Line 136 has weird spacing: '... String rse...' == Line 139 has weird spacing: '...nsigned rserp...' == (62 more instances...) == The document seems to use 'NOT RECOMMENDED' as an RFC 2119 keyword, but does not include the phrase in its RFC 2119 key words list. -- The document seems to lack a disclaimer for pre-RFC5378 work, but may have content which was first submitted before 10 November 2008. If you have contacted all the original authors and they are all willing to grant the BCP78 rights to the IETF Trust, then this is fine, and you can ignore this comment. If not, you may need to add the pre-RFC5378 disclaimer. (See the Legal Provisions document at https://trustee.ietf.org/license-info for more information.) -- The document date (March 9, 2009) is 5520 days in the past. Is this intentional? Checking references for intended status: Experimental ---------------------------------------------------------------------------- No issues found here. Summary: 2 errors (**), 0 flaws (~~), 8 warnings (==), 3 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Network Working Group T. Dreibholz 3 Internet-Draft University of Duisburg-Essen 4 Intended status: Experimental J. Mulik 5 Expires: September 10, 2009 Delaware State University 6 March 9, 2009 8 Reliable Server Pooling MIB Module Definition 9 draft-ietf-rserpool-mib-12.txt 11 Status of this Memo 13 This Internet-Draft is submitted to IETF in full conformance with the 14 provisions of BCP 78 and BCP 79. 16 Internet-Drafts are working documents of the Internet Engineering 17 Task Force (IETF), its areas, and its working groups. Note that 18 other groups may also distribute working documents as Internet- 19 Drafts. 21 Internet-Drafts are draft documents valid for a maximum of six months 22 and may be updated, replaced, or obsoleted by other documents at any 23 time. It is inappropriate to use Internet-Drafts as reference 24 material or to cite them other than as "work in progress." 26 The list of current Internet-Drafts can be accessed at 27 http://www.ietf.org/ietf/1id-abstracts.txt. 29 The list of Internet-Draft Shadow Directories can be accessed at 30 http://www.ietf.org/shadow.html. 32 This Internet-Draft will expire on September 10, 2009. 34 Copyright Notice 36 Copyright (c) 2009 IETF Trust and the persons identified as the 37 document authors. All rights reserved. 39 This document is subject to BCP 78 and the IETF Trust's Legal 40 Provisions Relating to IETF Documents 41 (http://trustee.ietf.org/license-info) in effect on the date of 42 publication of this document. Please review these documents 43 carefully, as they describe your rights and restrictions with respect 44 to this document. 46 Abstract 48 Reliable Server Pooling (RSerPool) is a framework to provide reliable 49 server pooling. The RSerPool frameworks consists of the two 50 protocols ASAP (Aggregate Server Access Protocol) and ENRP (Endpoint 51 Handlespace Redundancy Protocol). This document defines a SMIv2 52 compliant Management Information Base (MIB) module providing access 53 to managed objects in an RSerPool implementation. 55 Table of Contents 57 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 58 2. The Reliable Server Pooling (RSerPool) Framework . . . . . . . 3 59 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 3 60 4. The Internet-Standard Management Framework . . . . . . . . . . 3 61 5. Structure of the MIB . . . . . . . . . . . . . . . . . . . . . 3 62 5.1. Access to managed objects on ENRP servers . . . . . . . . 10 63 5.2. Access to managed objects on Pool Elements . . . . . . . . 11 64 5.3. Access to managed objects on Pool Users . . . . . . . . . 11 65 5.4. Persistency Behavior . . . . . . . . . . . . . . . . . . . 11 66 6. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 11 67 7. Operational Considerations . . . . . . . . . . . . . . . . . . 41 68 8. Security Considerations . . . . . . . . . . . . . . . . . . . 42 69 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 43 70 10. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 43 71 11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 44 72 11.1. Normative References . . . . . . . . . . . . . . . . . . . 44 73 11.2. Informative References . . . . . . . . . . . . . . . . . . 44 74 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 45 76 1. Introduction 78 This memo defines a Management Information Base (MIB) module which 79 describes managed objects for RSerPool implementations. 81 2. The Reliable Server Pooling (RSerPool) Framework 83 For a detailed overview of the documents that describe the current 84 Reliable Server Pooling (RSerPool) framework, please refer to 85 [RFC3237], [RFC5351], [RFC5352], [RFC5353], [RFC5354], [RFC5355] and 86 [RFC5356]. A more informal introduction can be found at 87 [RSerPoolPage] as well as in [Dre2006], [LCN2005] and [IJHIT2008]. 89 3. Conventions 91 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 92 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 93 document are to be interpreted as described in [RFC2119]. 95 4. The Internet-Standard Management Framework 97 For a detailed overview of the documents that describe the current 98 Internet-Standard Management Framework, please refer to section 7 of 99 RFC 3410 [RFC3410]. 101 Managed objects are accessed via a virtual information store, termed 102 the Management Information Base or MIB. MIB objects are generally 103 accessed through the Simple Network Management Protocol (SNMP). 104 Objects in the MIB are defined using the mechanisms defined in the 105 Structure of Management Information (SMI). This memo specifies a MIB 106 module that is compliant to the SMIv2, which is described in STD 58, 107 RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 108 [RFC2580]. The textual conventions are compliant to RFC 4001 109 [RFC4001]. 111 5. Structure of the MIB 113 The following diagram illustrates the structure of the MIB. 115 Structure of MIB 117 +--rserpoolMIB(XXX) 118 | 119 +--rserpoolMIBObjects(1) 120 | | 121 | +--rserpoolENRPServers(1) 122 | | | 123 | | +--rserpoolENRPTable(1) 124 | | | | 125 | | | +--rserpoolENRPEntry(1) 126 | | | | Index: rserpoolENRPIndex 127 | | | | 128 | | | +-- ---- Unsigned rserpoolENRPIndex(1) 129 | | | | Range: 1..4294967295 130 | | | +-- -R-- String rserpoolENRPOperationScope(2) 131 | | | | Textual Conv.: RSerPoolOperationScopeTC 132 | | | | Size: 0..65535 133 | | | +-- -R-- Unsigned rserpoolENRPIdentifier(3) 134 | | | | Textual Conv.: RSerPoolENRPServerIdentifierTC 135 | | | | Range: 1..4294967295 136 | | | +-- -RW- String rserpoolENRPDescription(4) 137 | | | | Size: 0..255 138 | | | +-- -R-- TimeTicks rserpoolENRPUptime(5) 139 | | | +-- -R-- Unsigned rserpoolENRPPort(6) 140 | | | | Textual Conv.: InetPortNumber 141 | | | | Range: 0..65535 142 | | | +-- -R-- Unsigned rserpoolENRPASAPAnnouncePort(7) 143 | | | | Textual Conv.: InetPortNumber 144 | | | | Range: 0..65535 145 | | | +-- -R-- EnumVal rserpoolENRPASAPAnnounceAddrType(8) 146 | | | | Textual Conv.: InetAddressType 147 | | | | Values: ipv4(1), ipv6(2) 148 | | | +-- -R-- String rserpoolENRPASAPAnnounceAddr(9) 149 | | | | Textual Conv.: InetAddress 150 | | | | Size: 4 | 16 151 | | | +-- -R-- Unsigned rserpoolENRPENRPAnnouncePort(10) 152 | | | | Textual Conv.: InetPortNumber 153 | | | | Range: 0..65535 154 | | | +-- -R-- EnumVal rserpoolENRPENRPAnnounceAddrType(11) 155 | | | | Textual Conv.: InetAddressType 156 | | | | Values: ipv4(1), ipv6(2) 157 | | | +-- -R-- String rserpoolENRPENRPAnnounceAddr(12) 158 | | | Textual Conv.: InetAddress 159 | | | Size: 4 | 16 160 | | | 161 | | +--rserpoolENRPPoolTable(3) 162 | | | | 163 | | | +--rserpoolENRPPoolEntry(1) 164 | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex 165 | | | | 166 | | | +-- ---- Unsigned rserpoolENRPPoolIndex(1) 167 | | | | Range: 1..4294967295 168 | | | +-- -R-- String rserpoolENRPPoolHandle(2) 169 | | | Textual Conv.: RSerPoolPoolHandleTC 170 | | | Size: 0..65535 171 | | | 172 | | +--rserpoolENRPPoolElementTable(4) 173 | | | | 174 | | | +--rserpoolENRPPoolElementEntry(1) 175 | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex, 176 | | | | rserpoolENRPPoolElementIndex 177 | | | | 178 | | | +-- ---- Unsigned rserpoolENRPPoolElementIndex(1) 179 | | | | Range: 1..4294967295 180 | | | +-- -R-- Unsigned rserpoolENRPPoolElementID(2) 181 | | | | Textual Conv.: RserpoolPoolElementIdentifierTC 182 | | | | Range: 1..4294967295 183 | | | +-- -R-- Unsigned rserpoolENRPASAPTransportPort(3) 184 | | | | Textual Conv.: InetPortNumber 185 | | | | Range: 0..65535 186 | | | +-- -R-- Unsigned rserpoolENRPUserTransportProto(4) 187 | | | | Range: 0..255 188 | | | +-- -R-- Unsigned rserpoolENRPUserTransportPort(5) 189 | | | | Textual Conv.: InetPortNumber 190 | | | | Range: 0..65535 191 | | | +-- -R-- EnumVal rserpoolENRPUserTransportUse(6) 192 | | | | Textual Conv.: RSerPoolTransportUseTypeTC 193 | | | | Values: dataOnly(0), dataPlusControl(1) 194 | | | +-- -R-- Unsigned rserpoolENRPPolicyID(7) 195 | | | | Textual Conv.: RSerPoolPolicyIdentifierTC 196 | | | | Range: 1..4294967295 197 | | | +-- -R-- String rserpoolENRPPolicyDescription(8) 198 | | | | Size: 0..255 199 | | | +-- -R-- Unsigned rserpoolENRPPolicyWeight(9) 200 | | | | Textual Conv.: RSerPoolPolicyWeightTC 201 | | | | Range: 0..4294967295 202 | | | +-- -R-- Unsigned rserpoolENRPPolicyLoad(10) 203 | | | | Textual Conv.: RSerPoolPolicyLoadTC 204 | | | | Range: 0..4294967295 205 | | | +-- -R-- Unsigned rserpoolENRPPolicyLoadDeg(11) 206 | | | | Textual Conv.: RSerPoolPolicyLoadTC 207 | | | | Range: 0..4294967295 208 | | | +-- -R-- TimeTicks rserpoolENRPRegistrationLife(12) 209 | | | +-- -R-- Unsigned rserpoolENRPHomeENRPServer(13) 210 | | | Textual Conv.: RSerPoolENRPServerIdentifierTC 211 | | | Range: 1..4294967295 212 | | | 213 | | +--rserpoolENRPASAPAddrTable(5) 214 | | | | 215 | | | +--rserpoolENRPASAPAddrTableEntry(1) 216 | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex, 217 | | | | rserpoolENRPPoolElementIndex, 218 | | | | rserpoolENRPASAPAddrTableIndex 219 | | | | 220 | | | +-- ---- Unsigned rserpoolENRPASAPAddrTableIndex(1) 221 | | | | Range: 1..4294967295 222 | | | +-- -R-- EnumVal rserpoolENRPASAPL3Type(2) 223 | | | | Textual Conv.: InetAddressType 224 | | | | Values: ipv4(1), ipv6(2) 225 | | | +-- -R-- String rserpoolENRPASAPL3Addr(3) 226 | | | Textual Conv.: InetAddress 227 | | | Size: 4 | 16 228 | | | 229 | | +--rserpoolENRPUserAddrTable(6) 230 | | | | 231 | | | +--rserpoolENRPUserAddrTableEntry(1) 232 | | | | Index: rserpoolENRPIndex, rserpoolENRPPoolIndex, 233 | | | | rserpoolENRPPoolElementIndex, 234 | | | | rserpoolENRPUserAddrTableIndex 235 | | | | 236 | | | +-- ---- Unsigned rserpoolENRPUserAddrTableIndex(1) 237 | | | | Range: 1..4294967295 238 | | | +-- -R-- EnumVal rserpoolENRPUserL3Type(2) 239 | | | | Textual Conv.: InetAddressType 240 | | | | Values: unknown(0), ipv4(1), ipv6(2) 241 | | | +-- -R-- String rserpoolENRPUserL3Addr(3) 242 | | | | Textual Conv.: InetAddress 243 | | | | Size: 0 | 4 | 16 244 | | | +-- -R-- String rserpoolENRPUserL3Opaque(4) 245 | | | Textual Conv.: RSerPoolOpaqueAddressTC 246 | | | Size: 0..65535 247 | | | 248 | | +--rserpoolENRPENRPAddrTable(7) 249 | | | | 250 | | | +--rserpoolENRPENRPAddrTableEntry(1) 251 | | | | Index: rserpoolENRPIndex, 252 | | | | rserpoolENRPENRPAddrTableIndex 253 | | | | 254 | | | +-- ---- Unsigned rserpoolENRPENRPAddrTableIndex(1) 255 | | | | Range: 1..4294967295 256 | | | +-- -R-- EnumVal rserpoolENRPENRPL3Type(2) 257 | | | | Textual Conv.: InetAddressType 258 | | | | Values: ipv4(1), ipv6(2) 259 | | | +-- -R-- String rserpoolENRPENRPL3Addr(3) 260 | | | Textual Conv.: InetAddress 261 | | | Size: 4 | 16 262 | | | 263 | | +--rserpoolENRPPeerTable(8) 264 | | | | 265 | | | +--rserpoolENRPPeerEntry(1) 266 | | | | Index: rserpoolENRPPeerIndex 267 | | | | 268 | | | +-- ---- Unsigned rserpoolENRPPeerIndex(1) 269 | | | | Range: 1..4294967295 270 | | | +-- -R-- Unsigned rserpoolENRPPeerIdentifier(2) 271 | | | | Textual Conv.: RSerPoolENRPServerIdentifierTC 272 | | | | Range: 1..4294967295 273 | | | +-- -R-- Unsigned rserpoolENRPPeerPort(3) 274 | | | | Textual Conv.: InetPortNumber 275 | | | | Range: 0..65535 276 | | | +-- -R-- TimeTicks rserpoolENRPPeerLastHeard(4) 277 | | | 278 | | +--rserpoolENRPPeerAddrTable(9) 279 | | | 280 | | +--rserpoolENRPPeerAddrTableEntry(1) 281 | | | Index: rserpoolENRPPeerIndex, 282 | | | | rserpoolENRPPeerAddrTableIndex 283 | | | 284 | | +-- ---- Unsigned rserpoolENRPPeerAddrTableIndex(1) 285 | | | Range: 1..4294967295 286 | | +-- -R-- EnumVal rserpoolENRPPeerL3Type(2) 287 | | | Textual Conv.: InetAddressType 288 | | | Values: ipv4(1), ipv6(2) 289 | | +-- -R-- String rserpoolENRPPeerL3Addr(3) 290 | | Textual Conv.: InetAddress 291 | | Size: 4 | 16 292 | | 293 | +--rserpoolPoolElements(2) 294 | | | 295 | | +--rserpoolPETable(1) 296 | | | | 297 | | | +--rserpoolPEEntry(1) 298 | | | | Index: rserpoolPEIndex 299 | | | | 300 | | | +-- ---- Unsigned rserpoolPEIndex(1) 301 | | | | Range: 1..4294967295 302 | | | +-- -R-- String rserpoolPEOperationScope(2) 303 | | | | Textual Conv.: RSerPoolOperationScopeTC 304 | | | | Size: 0..65535 305 | | | +-- -RW- String rserpoolPEPoolHandle(3) 306 | | | | Textual Conv.: RSerPoolPoolHandleTC 307 | | | | Size: 0..65535 308 | | | +-- -R-- Unsigned rserpoolPEIdentifier(4) 309 | | | | Textual Conv.: RserpoolPoolElementIdentifierTC 310 | | | | Range: 1..4294967295 311 | | | +-- -RW- String rserpoolPEDescription(5) 312 | | | | Size: 0..255 313 | | | +-- -R-- TimeTicks rserpoolPEUptime(6) 314 | | | +-- -R-- Unsigned rserpoolPEASAPTransportPort(7) 315 | | | | Textual Conv.: InetPortNumber 316 | | | | Range: 0..65535 317 | | | +-- -R-- Unsigned rserpoolPEUserTransportProto(8) 318 | | | | Range: 0..255 319 | | | +-- -R-- Unsigned rserpoolPEUserTransportPort(9) 320 | | | | Textual Conv.: InetPortNumber 321 | | | | Range: 0..65535 322 | | | +-- -R-- EnumVal rserpoolPEUserTransportUse(10) 323 | | | | Textual Conv.: RSerPoolTransportUseTypeTC 324 | | | | Values: dataOnly(0), dataPlusControl(1) 325 | | | +-- -RW- Unsigned rserpoolPEPolicyID(11) 326 | | | | Textual Conv.: RSerPoolPolicyIdentifierTC 327 | | | | Range: 1..4294967295 328 | | | +-- -RW- String rserpoolPEPolicyDescription(12) 329 | | | | Size: 0..255 330 | | | +-- -RW- Unsigned rserpoolPEPolicyWeight(13) 331 | | | | Textual Conv.: RSerPoolPolicyWeightTC 332 | | | | Range: 0..4294967295 333 | | | +-- -R-- Unsigned rserpoolPEPolicyLoad(14) 334 | | | | Textual Conv.: RSerPoolPolicyLoadTC 335 | | | | Range: 0..4294967295 336 | | | +-- -RW- Unsigned rserpoolPEPolicyLoadDeg(15) 337 | | | | Textual Conv.: RSerPoolPolicyLoadTC 338 | | | | Range: 0..4294967295 339 | | | +-- -RW- TimeTicks rserpoolPERegistrationLife(16) 340 | | | +-- -R-- Unsigned rserpoolPEHomeENRPServer(17) 341 | | | Textual Conv.: RSerPoolENRPServerIdentifierTC 342 | | | Range: 1..4294967295 343 | | | 344 | | +--rserpoolPEASAPAddrTable(2) 345 | | | | 346 | | | +--rserpoolPEASAPAddrTableEntry(1) 347 | | | | Index: rserpoolPEIndex, rserpoolPEASAPAddrTableIndex 348 | | | | 349 | | | +-- ---- Unsigned rserpoolPEASAPAddrTableIndex(1) 350 | | | | Range: 1..4294967295 351 | | | +-- -R-- EnumVal rserpoolPEASAPL3Type(2) 352 | | | | Textual Conv.: InetAddressType 353 | | | | Values: ipv4(1), ipv6(2) 354 | | | +-- -R-- String rserpoolPEASAPL3Addr(3) 355 | | | Textual Conv.: InetAddress 356 | | | Size: 4 | 16 357 | | | 358 | | +--rserpoolPEUserAddrTable(6) 359 | | | 360 | | +--rserpoolPEUserAddrTableEntry(1) 361 | | | Index: rserpoolPEIndex, rserpoolPEUserAddrTableIndex 362 | | | 363 | | +-- ---- Unsigned rserpoolPEUserAddrTableIndex(1) 364 | | | Range: 1..4294967295 365 | | +-- -R-- EnumVal rserpoolPEUserL3Type(2) 366 | | | Textual Conv.: InetAddressType 367 | | | Values: unknown(0), ipv4(1), ipv6(2) 368 | | +-- -R-- String rserpoolPEUserL3Addr(3) 369 | | | Textual Conv.: InetAddress 370 | | | Size: 0 | 4 | 16 371 | | +-- -R-- String rserpoolPEUserL3Opaque(4) 372 | | Textual Conv.: RSerPoolOpaqueAddressTC 373 | | Size: 0..65535 374 | | 375 | +--rserpoolPoolUsers(3) 376 | | 377 | +--rserpoolPUTable(1) 378 | | 379 | +--rserpoolPUEntry(1) 380 | | Index: rserpoolPUIndex 381 | | 382 | +-- ---- Unsigned rserpoolPUIndex(1) 383 | | Range: 1..4294967295 384 | +-- -R-- String rserpoolPUOperationScope(2) 385 | | Textual Conv.: RSerPoolOperationScopeTC 386 | | Size: 0..65535 387 | +-- -RW- String rserpoolPUPoolHandle(3) 388 | | Textual Conv.: RSerPoolPoolHandleTC 389 | | Size: 0..65535 390 | +-- -RW- String rserpoolPUDescription(4) 391 | | Size: 0..255 392 | +-- -R-- TimeTicks rserpoolPUUptime(5) 393 | 394 +--rserpoolMIBConformance(2) 395 | 396 +--rserpoolMIBCompliances(1) 397 | | 398 | +--rserpoolMIBCompliance(1) 399 | 400 +--rserpoolMIBGroups(2) 401 | 402 +--rserpoolENRPGroup(1) 403 +--rserpoolPEGroup(2) 404 +--rserpoolPUGroup(3) 406 As the figure shows, the MIB consists of three main branches: 407 "rserpoolENRP", "rserpoolPoolElements" and "rserpoolPoolUsers". The 408 first branch, "rserpoolENRP" is used to access managed objects in the 409 set of ENRP servers running on a given host. While it is assumed 410 that it does not make much sense to run multiple ENRP servers for the 411 same operation scope on one host, running multiple ENRP servers for 412 different operation scopes is very likely when the ENRP server 413 processes run on routers. Therefore, the MIB has to be able to 414 manage multiple ENRP servers on the same host. "rserpoolPoolElements" 415 is used to access managed objects in the set of Pool Elements that 416 are running on a given host. The third branch, "rserpoolPoolUsers" 417 is used to access managed objects in the set of Pool Users that are 418 running on a given host. Note: "rserpoolENRPServers" is filled on 419 hosts running ENRP server instances, "rserpoolPoolElements" is filled 420 on hosts running Pool Element instances and "rserpoolPoolUsers" is 421 filled on hosts running Pool User instances. Of course, multiple 422 different components may run on the same host, which leads to filling 423 of multiple different branches. In fact, the structure of the three 424 branches is very similar. Because the two branches are so similar, 425 we describe only the first branch in detail, and provide a summary 426 description of the second and third branch. We now proceed with a 427 description of the branches. 429 5.1. Access to managed objects on ENRP servers 431 The first branch describes managed objects at a set of ENRP servers. 432 Any given ENRP server of this set will, at a certain moment in time, 433 have registration information for a set of active pools. Each of 434 these pools in turn may have a list of pool elements that are 435 registered under that pool. To allow this information to be 436 retrieved via SNMP, the ERNP server branch of the RSerPool MIB uses 437 the table-in-table technique described in [SNMPMIBS]. Specifically, 438 the ENRP servers branch creates four levels of nesting, as indicated 439 in the following diagram: 441 Nesting of the ENRP Server Branch 443 Nesting Structure: 445 Level 1: rserpoolENRPTable 447 Level 2: rserpoolENRPPoolTable 448 Level 3: rserpoolENRPPoolElementTable 449 Level 4: rserpoolENRPASAPAddrTable 450 rserpoolENRPUserAddrTable 452 Level 2: rserpoolENRPENRPAddrTable 454 Level 2: rserpoolENRPPeerTable 455 Level 3: rserpoolENRPPeerAddrTable 457 5.2. Access to managed objects on Pool Elements 459 The construction of the Pool Elements branch is very similar to the 460 pool elements table of the ENRP servers branch. But instead of 461 grouping the pool elements into pools (which does not make sense 462 here), the pool elements table is the top of the hierarchy and each 463 pool element entry specifies its operation scope and pool handle. 464 That is, the nesting structure is as follows: 466 Nesting of the Pool Elements Branch 468 Level 1: rserpoolPETable 469 Level 2: rserpoolPEASAPAddrTable 470 rserpoolPEUserAddrTable 472 5.3. Access to managed objects on Pool Users 474 For the pool users branch, it is only necessary to list the pool user 475 instances, including their operation scope and pool handle. 477 5.4. Persistency Behavior 479 Upon changes of writable objects, an implementation SHOULD store the 480 new values in a persistent manner if it has the capability to do 481 this. An implementation SHOULD use these stored values upon reset or 482 reinitialization. 484 6. Definitions 485 RSERPOOL-MIB DEFINITIONS ::= BEGIN 487 IMPORTS 488 MODULE-IDENTITY, OBJECT-TYPE, experimental, 489 TimeTicks, Unsigned32 490 FROM SNMPv2-SMI 491 TEXTUAL-CONVENTION 492 FROM SNMPv2-TC 493 MODULE-COMPLIANCE, OBJECT-GROUP 494 FROM SNMPv2-CONF 495 InetAddressType, InetAddress, InetPortNumber 496 FROM INET-ADDRESS-MIB; 498 -- ## Module definition ########################################### 499 rserpoolMIB MODULE-IDENTITY 500 LAST-UPDATED 501 "200903071111Z" -- March 07, 2009 502 ORGANIZATION 503 "IEM-TdR, UNIVERSITY OF DUISBURG-ESSEN" 504 CONTACT-INFO 505 " THOMAS-DREIBHOLZ 507 Postal: University of Duisburg-Essen 508 Institute for Experimental Mathematics 509 Ellernstrasse 29 510 D-45326 Essen 511 Germany 512 Phone: +49-201-183-7637 513 Fax: +49-201-183-7673 514 Email: dreibh@iem.uni-due.de 516 JAIWANT-MULIK 518 Postal: Delaware State University 519 CIS Department 520 1200 N. DuPont Hw 521 Dover, DE 522 USA 19904 523 Phone: +1-302-857-7910 524 Fax: +1-302-857-6552 525 Email: jaiwant@mulik.com" 526 DESCRIPTION 527 "The MIB module for managing an RSerPool implementation. 529 Copyright (c) 2009 IETF Trust and the persons identified as 530 authors of RFC XXXX. 531 This version of this MIB module is part of RFC XXXX; see the 532 RFC itself for full legal notices." 534 REVISION 535 "200903071111Z" -- March 07, 2009 536 DESCRIPTION 537 "This version of the MIB module is published as RFC XXXX" 538 ::= { experimental XXX } -- To be IANA Assigned!!! 540 -- ## RSerPool type definitions ################################### 541 RSerPoolENRPServerIdentifierTC ::= TEXTUAL-CONVENTION 542 DISPLAY-HINT "x" 543 STATUS current 544 DESCRIPTION "The ID of an ENRP server" 545 SYNTAX Unsigned32 (1..4294967295) 547 RSerPoolOperationScopeTC ::= TEXTUAL-CONVENTION 548 DISPLAY-HINT "1024t" 549 STATUS current 550 DESCRIPTION "The ID of an operation scope" 551 SYNTAX OCTET STRING (SIZE (0..65535)) 553 RSerPoolPoolHandleTC ::= TEXTUAL-CONVENTION 554 DISPLAY-HINT "1024t" 555 STATUS current 556 DESCRIPTION "The pool handle" 557 SYNTAX OCTET STRING (SIZE (0..65535)) 559 RserpoolPoolElementIdentifierTC ::= TEXTUAL-CONVENTION 560 DISPLAY-HINT "x" 561 STATUS current 562 DESCRIPTION "The pool element ID" 563 SYNTAX Unsigned32 (1..4294967295) 565 RSerPoolPolicyIdentifierTC ::= TEXTUAL-CONVENTION 566 DISPLAY-HINT "x" 567 STATUS current 568 DESCRIPTION "The ID of the pool policy" 569 SYNTAX Unsigned32 (1..4294967295) 571 RSerPoolPolicyLoadTC ::= TEXTUAL-CONVENTION 572 DISPLAY-HINT "d" 573 STATUS current 574 DESCRIPTION "The load status of a pool element" 575 SYNTAX Unsigned32 (0..4294967295) 577 RSerPoolPolicyWeightTC ::= TEXTUAL-CONVENTION 578 DISPLAY-HINT "d" 579 STATUS current 580 DESCRIPTION "The weight of a pool element" 581 SYNTAX Unsigned32 (0..4294967295) 583 RSerPoolTransportUseTypeTC ::= TEXTUAL-CONVENTION 584 STATUS current 585 DESCRIPTION "The transport use of a pool element" 586 SYNTAX INTEGER { 587 dataOnly(0), 588 dataPlusControl(1) 589 } 591 RSerPoolOpaqueAddressTC ::= TEXTUAL-CONVENTION 592 DISPLAY-HINT "1024t" 593 STATUS current 594 DESCRIPTION "Opaque address" 595 SYNTAX OCTET STRING (SIZE (0..65535)) 597 -- ## Top-level definitions ####################################### 598 rserpoolMIBObjects OBJECT IDENTIFIER ::= { rserpoolMIB 1 } 599 rserpoolMIBConformance OBJECT IDENTIFIER ::= { rserpoolMIB 2 } 601 rserpoolENRPServers OBJECT IDENTIFIER ::= { rserpoolMIBObjects 1 } 602 rserpoolPoolElements OBJECT IDENTIFIER ::= { rserpoolMIBObjects 2 } 603 rserpoolPoolUsers OBJECT IDENTIFIER ::= { rserpoolMIBObjects 3 } 605 -- ################################################################ 606 -- #### ENRP Servers Section #### 607 -- ################################################################ 609 -- ## Definition of the ENRP server table ######################### 610 rserpoolENRPTable OBJECT-TYPE 611 SYNTAX SEQUENCE OF RserpoolENRPEntry 612 MAX-ACCESS not-accessible 613 STATUS current 614 DESCRIPTION 615 "The table listing of ENRP servers." 616 ::= { rserpoolENRPServers 1 } 618 rserpoolENRPEntry OBJECT-TYPE 619 SYNTAX RserpoolENRPEntry 620 MAX-ACCESS not-accessible 621 STATUS current 622 DESCRIPTION 623 "An ENRP server entry in the table listing of ENRP 624 servers." 625 INDEX { rserpoolENRPIndex } 626 ::= { rserpoolENRPTable 1 } 628 RserpoolENRPEntry ::= SEQUENCE { 629 rserpoolENRPIndex Unsigned32, 630 rserpoolENRPOperationScope RSerPoolOperationScopeTC, 631 rserpoolENRPIdentifier RSerPoolENRPServerIdentifierTC, 632 rserpoolENRPDescription OCTET STRING, 633 rserpoolENRPUptime TimeTicks, 634 rserpoolENRPPort InetPortNumber, 635 rserpoolENRPASAPAnnouncePort InetPortNumber, 636 rserpoolENRPASAPAnnounceAddrType InetAddressType, 637 rserpoolENRPASAPAnnounceAddr InetAddress, 638 rserpoolENRPENRPAnnouncePort InetPortNumber, 639 rserpoolENRPENRPAnnounceAddrType InetAddressType, 640 rserpoolENRPENRPAnnounceAddr InetAddress } 642 rserpoolENRPIndex OBJECT-TYPE 643 SYNTAX Unsigned32 (1..4294967295) 644 MAX-ACCESS not-accessible 645 STATUS current 646 DESCRIPTION 647 "An integer to uniquely identify an ENRP server." 648 ::= { rserpoolENRPEntry 1 } 650 rserpoolENRPOperationScope OBJECT-TYPE 651 SYNTAX RSerPoolOperationScopeTC 652 MAX-ACCESS read-only 653 STATUS current 654 DESCRIPTION 655 "The definition of the operation scope of this ENRP server." 656 REFERENCE 657 "Section 1.2 of RFC 3237 defines the term operation scope." 658 ::= { rserpoolENRPEntry 2 } 660 rserpoolENRPIdentifier OBJECT-TYPE 661 SYNTAX RSerPoolENRPServerIdentifierTC 662 MAX-ACCESS read-only 663 STATUS current 664 DESCRIPTION 665 "The ENRP server identifier of this ENRP server." 666 REFERENCE 667 "Section 3.1 of RFC 5351 explains the ENRP server identifier." 668 ::= { rserpoolENRPEntry 3 } 670 rserpoolENRPDescription OBJECT-TYPE 671 SYNTAX OCTET STRING (SIZE (0..255)) 672 MAX-ACCESS read-write 673 STATUS current 674 DESCRIPTION 675 "A textual description of this ENRP server, e.g. its location 676 and a contact address of its administrator. 678 This object SHOULD be maintained in a persistent manner." 679 ::= { rserpoolENRPEntry 4 } 681 rserpoolENRPUptime OBJECT-TYPE 682 SYNTAX TimeTicks 683 MAX-ACCESS read-only 684 STATUS current 685 DESCRIPTION 686 "The ENRP service uptime of this ENRP server." 687 ::= { rserpoolENRPEntry 5 } 689 rserpoolENRPPort OBJECT-TYPE 690 SYNTAX InetPortNumber 691 MAX-ACCESS read-only 692 STATUS current 693 DESCRIPTION 694 "The SCTP port number of the ENRP protocol endpoint of 695 this ENRP server." 696 REFERENCE 697 "RFC 5353 defines the ENRP protocol." 698 ::= { rserpoolENRPEntry 6 } 700 rserpoolENRPASAPAnnouncePort OBJECT-TYPE 701 SYNTAX InetPortNumber 702 MAX-ACCESS read-only 703 STATUS current 704 DESCRIPTION 705 "The destination UDP port number ASAP multicast announce 706 messages are sent to." 707 REFERENCE 708 "Section 3.2 of RFC 5351 explains the server discovery mechanism 709 using ASAP announces." 710 ::= { rserpoolENRPEntry 7 } 712 rserpoolENRPASAPAnnounceAddrType OBJECT-TYPE 713 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 714 MAX-ACCESS read-only 715 STATUS current 716 DESCRIPTION 717 "The network-layer protocol ASAP multicast announce messages 718 are sent over." 719 REFERENCE 720 "Section 3.2 of RFC 5351 explains the server discovery mechanism 721 using ASAP announces." 722 ::= { rserpoolENRPEntry 8 } 724 rserpoolENRPASAPAnnounceAddr OBJECT-TYPE 725 SYNTAX InetAddress (SIZE(4|16)) 726 MAX-ACCESS read-only 727 STATUS current 728 DESCRIPTION 729 "The destination IP multicast address ASAP multicast 730 announce messages are sent to. The type of this address is 731 given in rserpoolENRPASAPAnnounceAddrType." 732 REFERENCE 733 "Section 3.2 of RFC 5351 explains the server discovery mechanism 734 using ASAP announces." 735 ::= { rserpoolENRPEntry 9 } 737 rserpoolENRPENRPAnnouncePort OBJECT-TYPE 738 SYNTAX InetPortNumber 739 MAX-ACCESS read-only 740 STATUS current 741 DESCRIPTION 742 "The destination UDP port number ENRP multicast announce 743 messages are sent to." 744 REFERENCE 745 "Section 3.1 of RFC 5353 explains the ENRP multicast 746 announce mechanism." 747 ::= { rserpoolENRPEntry 10 } 749 rserpoolENRPENRPAnnounceAddrType OBJECT-TYPE 750 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 751 MAX-ACCESS read-only 752 STATUS current 753 DESCRIPTION 754 "The network-layer protocol ENRP multicast announce messages 755 are sent over." 756 REFERENCE 757 "Section 3.1 of RFC 5353 explains the ENRP multicast 758 announce mechanism." 759 ::= { rserpoolENRPEntry 11 } 761 rserpoolENRPENRPAnnounceAddr OBJECT-TYPE 762 SYNTAX InetAddress (SIZE(4|16)) 763 MAX-ACCESS read-only 764 STATUS current 765 DESCRIPTION 766 "The destination multicast IP address ENRP multicast 767 announce messages are sent to. The type of this address 768 is given in rserpoolENRPENRPAnnounceAddrType." 769 REFERENCE 770 "Section 3.1 of RFC 5353 explains the ENRP multicast 771 announce mechanism." 772 ::= { rserpoolENRPEntry 12 } 774 -- ## Definition of the pool table ################################ 775 rserpoolENRPPoolTable OBJECT-TYPE 776 SYNTAX SEQUENCE OF RserpoolENRPPoolEntry 777 MAX-ACCESS not-accessible 778 STATUS current 779 DESCRIPTION 780 "The table listing of pools." 781 ::= { rserpoolENRPServers 3 } 783 rserpoolENRPPoolEntry OBJECT-TYPE 784 SYNTAX RserpoolENRPPoolEntry 785 MAX-ACCESS not-accessible 786 STATUS current 787 DESCRIPTION 788 "The pool entry in the table listing of pools." 789 INDEX { rserpoolENRPIndex, rserpoolENRPPoolIndex } 790 ::= { rserpoolENRPPoolTable 1 } 792 RserpoolENRPPoolEntry ::= SEQUENCE { 793 rserpoolENRPPoolIndex Unsigned32, 794 rserpoolENRPPoolHandle RSerPoolPoolHandleTC } 796 rserpoolENRPPoolIndex OBJECT-TYPE 797 SYNTAX Unsigned32 (1..4294967295) 798 MAX-ACCESS not-accessible 799 STATUS current 800 DESCRIPTION 801 "An integer to uniquely identify a pool." 802 ::= { rserpoolENRPPoolEntry 1 } 804 rserpoolENRPPoolHandle OBJECT-TYPE 805 SYNTAX RSerPoolPoolHandleTC 806 MAX-ACCESS read-only 807 STATUS current 808 DESCRIPTION 809 "The pool handle of this pool." 810 REFERENCE 811 "Section 1.2 of RFC 3237 defines the term pool handle." 812 ::= { rserpoolENRPPoolEntry 2 } 814 -- ## Definition of the pool element table ######################## 815 rserpoolENRPPoolElementTable OBJECT-TYPE 816 SYNTAX SEQUENCE OF RserpoolENRPPoolElementEntry 817 MAX-ACCESS not-accessible 818 STATUS current 819 DESCRIPTION 820 "The table listing of pool elements." 821 ::= { rserpoolENRPServers 4 } 823 rserpoolENRPPoolElementEntry OBJECT-TYPE 824 SYNTAX RserpoolENRPPoolElementEntry 825 MAX-ACCESS not-accessible 826 STATUS current 827 DESCRIPTION 828 "A pool element in the table listing of pool elements." 829 INDEX { 830 rserpoolENRPIndex, 831 rserpoolENRPPoolIndex, 832 rserpoolENRPPoolElementIndex } 833 ::= { rserpoolENRPPoolElementTable 1 } 835 RserpoolENRPPoolElementEntry ::= SEQUENCE { 836 rserpoolENRPPoolElementIndex Unsigned32, 837 rserpoolENRPPoolElementID RserpoolPoolElementIdentifierTC, 838 rserpoolENRPASAPTransportPort InetPortNumber, 839 rserpoolENRPUserTransportProto Unsigned32, 840 rserpoolENRPUserTransportPort InetPortNumber, 841 rserpoolENRPUserTransportUse RSerPoolTransportUseTypeTC, 842 rserpoolENRPPolicyID RSerPoolPolicyIdentifierTC, 843 rserpoolENRPPolicyDescription OCTET STRING, 844 rserpoolENRPPolicyWeight RSerPoolPolicyWeightTC, 845 rserpoolENRPPolicyLoad RSerPoolPolicyLoadTC, 846 rserpoolENRPPolicyLoadDeg RSerPoolPolicyLoadTC, 847 rserpoolENRPRegistrationLife TimeTicks, 848 rserpoolENRPHomeENRPServer RSerPoolENRPServerIdentifierTC } 850 rserpoolENRPPoolElementIndex OBJECT-TYPE 851 SYNTAX Unsigned32 (1..4294967295) 852 MAX-ACCESS not-accessible 853 STATUS current 854 DESCRIPTION 855 "An integer to uniquely identify a pool element. Note, 856 that uniqueness of a pool element identifier in the pool 857 is not enforced, therefore this index is required here!" 858 ::={ rserpoolENRPPoolElementEntry 1 } 860 rserpoolENRPPoolElementID OBJECT-TYPE 861 SYNTAX RserpoolPoolElementIdentifierTC 862 MAX-ACCESS read-only 863 STATUS current 864 DESCRIPTION 865 "The pool element identifier of this pool element." 866 REFERENCE 867 "Section 2.2 of RFC 5351 explains the pool element identifier 868 usage." 869 ::={ rserpoolENRPPoolElementEntry 2 } 871 rserpoolENRPASAPTransportPort OBJECT-TYPE 872 SYNTAX InetPortNumber 873 MAX-ACCESS read-only 874 STATUS current 875 DESCRIPTION 876 "The SCTP port number of the ASAP endpoint of this pool 877 element." 878 REFERENCE 879 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 880 which the port number is given here." 881 ::= { rserpoolENRPPoolElementEntry 3 } 883 rserpoolENRPUserTransportProto OBJECT-TYPE 884 SYNTAX Unsigned32 (0..255) 885 MAX-ACCESS read-only 886 STATUS current 887 DESCRIPTION 888 "The transport protocol number of the service endpoint 889 of this pool element." 890 REFERENCE 891 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 892 which the transport protocol number is given here." 893 ::= { rserpoolENRPPoolElementEntry 4 } 895 rserpoolENRPUserTransportPort OBJECT-TYPE 896 SYNTAX InetPortNumber 897 MAX-ACCESS read-only 898 STATUS current 899 DESCRIPTION 900 "The transport protocol's port number of the service 901 endpoint of this pool element." 902 REFERENCE 903 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 904 which the port number is given here." 905 ::= { rserpoolENRPPoolElementEntry 5 } 907 rserpoolENRPUserTransportUse OBJECT-TYPE 908 SYNTAX RSerPoolTransportUseTypeTC 909 MAX-ACCESS read-only 910 STATUS current 911 DESCRIPTION 912 "The transport use of the service endpoint of this pool 913 element." 914 REFERENCE 915 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 916 which the transport use is given here." 917 ::= { rserpoolENRPPoolElementEntry 6 } 919 rserpoolENRPPolicyID OBJECT-TYPE 920 SYNTAX RSerPoolPolicyIdentifierTC 921 MAX-ACCESS read-only 922 STATUS current 923 DESCRIPTION 924 "The pool policy of this pool element." 925 REFERENCE 926 "Section 3.8 of RFC 5354 defines the Member Selection Policy 927 Parameter of which the policy identifier is given here." 928 ::= { rserpoolENRPPoolElementEntry 7 } 930 rserpoolENRPPolicyDescription OBJECT-TYPE 931 SYNTAX OCTET STRING (SIZE (0..255)) 932 MAX-ACCESS read-only 933 STATUS current 934 DESCRIPTION 935 "The textual description of the pool policy of this pool 936 element." 937 ::= { rserpoolENRPPoolElementEntry 8 } 939 rserpoolENRPPolicyWeight OBJECT-TYPE 940 SYNTAX RSerPoolPolicyWeightTC 941 MAX-ACCESS read-only 942 STATUS current 943 DESCRIPTION 944 "The pool policy's weight parameter for this pool element." 945 REFERENCE 946 "Section 3.8 of RFC 5354 defines the Member Selection Policy 947 Parameter of which the policy's weight parameter is given here." 948 ::= { rserpoolENRPPoolElementEntry 9 } 950 rserpoolENRPPolicyLoad OBJECT-TYPE 951 SYNTAX RSerPoolPolicyLoadTC 952 MAX-ACCESS read-only 953 STATUS current 954 DESCRIPTION 955 "The pool policy's load status for this pool element." 956 REFERENCE 957 "Section 3.8 of RFC 5354 defines the Member Selection Policy 958 Parameter of which the policy's load parameter is given here." 959 ::= { rserpoolENRPPoolElementEntry 10 } 961 rserpoolENRPPolicyLoadDeg OBJECT-TYPE 962 SYNTAX RSerPoolPolicyLoadTC 963 MAX-ACCESS read-only 964 STATUS current 965 DESCRIPTION 966 "The pool policy's load degradation parameter for this pool 967 element." 968 REFERENCE 969 "Section 3.8 of RFC 5354 defines the Member Selection Policy 970 Parameter of which the policy's load degradation parameter is 971 given here." 972 ::= { rserpoolENRPPoolElementEntry 11 } 974 rserpoolENRPRegistrationLife OBJECT-TYPE 975 SYNTAX TimeTicks 976 MAX-ACCESS read-only 977 STATUS current 978 DESCRIPTION 979 "The registration life of this pool element." 980 REFERENCE 981 "Section 3.10 of RFC 5354 defines the Registration Life." 982 ::= { rserpoolENRPPoolElementEntry 12 } 984 rserpoolENRPHomeENRPServer OBJECT-TYPE 985 SYNTAX RSerPoolENRPServerIdentifierTC 986 MAX-ACCESS read-only 987 STATUS current 988 DESCRIPTION 989 "The ID of the home ENRP server of this pool element." 990 REFERENCE 991 "Section 3.10 of RFC 5354 defines the Home ENRP Server 992 Identifier." 993 ::= { rserpoolENRPPoolElementEntry 13 } 995 -- ## Definition of the ASAP transport address list table ######### 996 rserpoolENRPASAPAddrTable OBJECT-TYPE 997 SYNTAX SEQUENCE OF RserpoolENRPASAPAddrTableEntry 998 MAX-ACCESS not-accessible 999 STATUS current 1000 DESCRIPTION 1001 "A table listing of all IP addresses of the ASAP transport 1002 endpoint." 1003 REFERENCE 1004 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1005 which the addresses are listed in this table." 1006 ::= { rserpoolENRPServers 5 } 1008 rserpoolENRPASAPAddrTableEntry OBJECT-TYPE 1009 SYNTAX RserpoolENRPASAPAddrTableEntry 1010 MAX-ACCESS not-accessible 1011 STATUS current 1012 DESCRIPTION 1013 "An IP address of the ASAP transport endpoint." 1014 REFERENCE 1015 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1016 which an address is contained by this entry." 1017 INDEX { 1018 rserpoolENRPIndex, 1019 rserpoolENRPPoolIndex, 1020 rserpoolENRPPoolElementIndex, 1021 rserpoolENRPASAPAddrTableIndex } 1022 ::= { rserpoolENRPASAPAddrTable 1 } 1024 RserpoolENRPASAPAddrTableEntry ::= SEQUENCE { 1025 rserpoolENRPASAPAddrTableIndex Unsigned32, 1026 rserpoolENRPASAPL3Type InetAddressType, 1027 rserpoolENRPASAPL3Addr InetAddress } 1029 rserpoolENRPASAPAddrTableIndex OBJECT-TYPE 1030 SYNTAX Unsigned32 (1..4294967295) 1031 MAX-ACCESS not-accessible 1032 STATUS current 1033 DESCRIPTION 1034 "A unique identifier for the IP address of an ASAP transport 1035 endpoint." 1036 ::= { rserpoolENRPASAPAddrTableEntry 1 } 1038 rserpoolENRPASAPL3Type OBJECT-TYPE 1039 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 1040 MAX-ACCESS read-only 1041 STATUS current 1042 DESCRIPTION 1043 "The network-layer protocol (IPv4 or IPv6) of an IP address of 1044 an ASAP transport endpoint." 1045 REFERENCE 1046 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1047 which the network-layer protocol number is given here." 1048 ::= { rserpoolENRPASAPAddrTableEntry 2 } 1050 rserpoolENRPASAPL3Addr OBJECT-TYPE 1051 SYNTAX InetAddress (SIZE(4|16)) 1052 MAX-ACCESS read-only 1053 STATUS current 1054 DESCRIPTION 1055 "The IP address of an ASAP transport endpoint. The type of 1056 this address is given in rserpoolENRPASAPL3Type." 1057 REFERENCE 1058 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1059 which the network-layer address (IPv4 or IPv6) is given here." 1060 ::= { rserpoolENRPASAPAddrTableEntry 3 } 1062 -- ## Definition of the user transport address list table ######### 1063 rserpoolENRPUserAddrTable OBJECT-TYPE 1064 SYNTAX SEQUENCE OF RserpoolENRPUserAddrTableEntry 1065 MAX-ACCESS not-accessible 1066 STATUS current 1067 DESCRIPTION 1068 "A table listing of all IP addresses of the user 1069 transport endpoint." 1070 REFERENCE 1071 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1072 which the addresses are listed in this table." 1073 ::= { rserpoolENRPServers 6 } 1075 rserpoolENRPUserAddrTableEntry OBJECT-TYPE 1076 SYNTAX RserpoolENRPUserAddrTableEntry 1077 MAX-ACCESS not-accessible 1078 STATUS current 1079 DESCRIPTION 1080 "An IP address of the user transport endpoint." 1081 REFERENCE 1082 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1083 which an address is contained by this entry." 1084 INDEX { 1085 rserpoolENRPIndex, 1086 rserpoolENRPPoolIndex, 1087 rserpoolENRPPoolElementIndex, 1088 rserpoolENRPUserAddrTableIndex } 1089 ::= { rserpoolENRPUserAddrTable 1 } 1091 RserpoolENRPUserAddrTableEntry ::= SEQUENCE { 1092 rserpoolENRPUserAddrTableIndex Unsigned32, 1093 rserpoolENRPUserL3Type InetAddressType, 1094 rserpoolENRPUserL3Addr InetAddress, 1095 rserpoolENRPUserL3Opaque RSerPoolOpaqueAddressTC } 1097 rserpoolENRPUserAddrTableIndex OBJECT-TYPE 1098 SYNTAX Unsigned32 (1..4294967295) 1099 MAX-ACCESS not-accessible 1100 STATUS current 1101 DESCRIPTION 1102 "A unique identifier for the IP address of an user transport 1103 endpoint." 1104 ::= { rserpoolENRPUserAddrTableEntry 1 } 1106 rserpoolENRPUserL3Type OBJECT-TYPE 1107 SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) } 1108 MAX-ACCESS read-only 1109 STATUS current 1110 DESCRIPTION 1111 "The network-layer protocol (IPv4 or IPv6) of an IP address 1112 of an user transport endpoint. Set to unknown for opaque address." 1113 REFERENCE 1114 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1115 which the network-layer protocol number is given here." 1116 ::= { rserpoolENRPUserAddrTableEntry 2 } 1118 rserpoolENRPUserL3Addr OBJECT-TYPE 1119 SYNTAX InetAddress (SIZE(0|4|16)) 1120 MAX-ACCESS read-only 1121 STATUS current 1122 DESCRIPTION 1123 "The IP address of an user transport endpoint. The type of 1124 this address is given in rserpoolENRPUserL3Type." 1125 REFERENCE 1126 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1127 which the network-layer address (IPv4 or IPv6) is given here." 1128 ::= { rserpoolENRPUserAddrTableEntry 3 } 1130 rserpoolENRPUserL3Opaque OBJECT-TYPE 1131 SYNTAX RSerPoolOpaqueAddressTC 1132 MAX-ACCESS read-only 1133 STATUS current 1134 DESCRIPTION 1135 "The opaque address of an user transport endpoint." 1136 REFERENCE 1137 "Section 3.16 of RFC 5354 defines the opaque transport address." 1138 ::= { rserpoolENRPUserAddrTableEntry 4 } 1140 -- ## Definition of ENRP address list table ####################### 1141 rserpoolENRPENRPAddrTable OBJECT-TYPE 1142 SYNTAX SEQUENCE OF RserpoolENRPENRPAddrTableEntry 1143 MAX-ACCESS not-accessible 1144 STATUS current 1145 DESCRIPTION 1146 "A table listing of all IP addresses of the ENRP 1147 transport endpoint." 1148 ::= { rserpoolENRPServers 7 } 1150 rserpoolENRPENRPAddrTableEntry OBJECT-TYPE 1151 SYNTAX RserpoolENRPENRPAddrTableEntry 1152 MAX-ACCESS not-accessible 1153 STATUS current 1154 DESCRIPTION 1155 "An IP address of the ENRP transport endpoint." 1156 INDEX { 1157 rserpoolENRPIndex, 1158 rserpoolENRPENRPAddrTableIndex } 1159 ::= { rserpoolENRPENRPAddrTable 1 } 1161 RserpoolENRPENRPAddrTableEntry ::= SEQUENCE { 1162 rserpoolENRPENRPAddrTableIndex Unsigned32, 1163 rserpoolENRPENRPL3Type InetAddressType, 1164 rserpoolENRPENRPL3Addr InetAddress } 1166 rserpoolENRPENRPAddrTableIndex OBJECT-TYPE 1167 SYNTAX Unsigned32 (1..4294967295) 1168 MAX-ACCESS not-accessible 1169 STATUS current 1170 DESCRIPTION 1171 "A unique identifier for the IP address of an ENRP transport 1172 endpoint." 1173 ::= { rserpoolENRPENRPAddrTableEntry 1 } 1175 rserpoolENRPENRPL3Type OBJECT-TYPE 1176 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 1177 MAX-ACCESS read-only 1178 STATUS current 1179 DESCRIPTION 1180 "The network-layer protocol (IPv4 or IPv6) of an IP address of 1181 an ENRP transport endpoint." 1182 REFERENCE 1183 "RFC 5353 defines the ENRP protocol." 1184 ::= { rserpoolENRPENRPAddrTableEntry 2 } 1186 rserpoolENRPENRPL3Addr OBJECT-TYPE 1187 SYNTAX InetAddress (SIZE(4|16)) 1188 MAX-ACCESS read-only 1189 STATUS current 1190 DESCRIPTION 1191 "The IP address of an ENRP transport endpoint. The type of 1192 this address is given in rserpoolENRPENRPL3Type." 1193 REFERENCE 1194 "RFC 5353 defines the ENRP protocol." 1195 ::= { rserpoolENRPENRPAddrTableEntry 3 } 1197 -- ## Definition of peer table #################################### 1198 rserpoolENRPPeerTable OBJECT-TYPE 1199 SYNTAX SEQUENCE OF RserpoolENRPPeerEntry 1200 MAX-ACCESS not-accessible 1201 STATUS current 1202 DESCRIPTION 1203 "The table listing of a peer table." 1204 ::= { rserpoolENRPServers 8 } 1206 rserpoolENRPPeerEntry OBJECT-TYPE 1207 SYNTAX RserpoolENRPPeerEntry 1208 MAX-ACCESS not-accessible 1209 STATUS current 1210 DESCRIPTION 1211 "A peer entry in the table listing of a peer table." 1212 INDEX { rserpoolENRPPeerIndex } 1213 ::= { rserpoolENRPPeerTable 1 } 1215 RserpoolENRPPeerEntry ::= SEQUENCE { 1216 rserpoolENRPPeerIndex Unsigned32, 1217 rserpoolENRPPeerIdentifier RSerPoolENRPServerIdentifierTC, 1218 rserpoolENRPPeerPort InetPortNumber, 1219 rserpoolENRPPeerLastHeard TimeTicks } 1221 rserpoolENRPPeerIndex OBJECT-TYPE 1222 SYNTAX Unsigned32 (1..4294967295) 1223 MAX-ACCESS not-accessible 1224 STATUS current 1225 DESCRIPTION 1226 "A unique identifier for a peer entry in the table 1227 listing of a peer table." 1228 ::= { rserpoolENRPPeerEntry 1 } 1230 rserpoolENRPPeerIdentifier OBJECT-TYPE 1231 SYNTAX RSerPoolENRPServerIdentifierTC 1232 MAX-ACCESS read-only 1233 STATUS current 1234 DESCRIPTION 1235 "The ENRP identifier of this peer." 1236 REFERENCE 1237 "RFC 5353 explains the usage of the ENRP server identifier." 1238 ::= { rserpoolENRPPeerEntry 2 } 1240 rserpoolENRPPeerPort OBJECT-TYPE 1241 SYNTAX InetPortNumber 1242 MAX-ACCESS read-only 1243 STATUS current 1244 DESCRIPTION 1245 "The SCTP port number of the ENRP transport endpoint of 1246 this peer." 1247 REFERENCE 1248 "RFC 5353 defines the ENRP protocol." 1249 ::= { rserpoolENRPPeerEntry 3 } 1251 rserpoolENRPPeerLastHeard OBJECT-TYPE 1252 SYNTAX TimeTicks 1253 MAX-ACCESS read-only 1254 STATUS current 1255 DESCRIPTION 1256 "The time since the reception of the last ENRP Presence 1257 message of this peer." 1258 REFERENCE 1259 "Section 4.1 of RFC 5353 defines the last heard value." 1260 ::= { rserpoolENRPPeerEntry 4 } 1262 -- ## Definition of peer address list table ####################### 1263 rserpoolENRPPeerAddrTable OBJECT-TYPE 1264 SYNTAX SEQUENCE OF RserpoolENRPPeerAddrTableEntry 1265 MAX-ACCESS not-accessible 1266 STATUS current 1267 DESCRIPTION 1268 "A table listing of the peer endpoint addresses." 1269 ::= { rserpoolENRPServers 9 } 1271 rserpoolENRPPeerAddrTableEntry OBJECT-TYPE 1272 SYNTAX RserpoolENRPPeerAddrTableEntry 1273 MAX-ACCESS not-accessible 1274 STATUS current 1275 DESCRIPTION 1276 "A table listing of all IP addresses of the ENRP 1277 transport endpoint of a peer referenced by rserpoolENRPPeerIndex." 1278 INDEX { 1279 rserpoolENRPPeerIndex, 1280 rserpoolENRPPeerAddrTableIndex } 1281 ::= { rserpoolENRPPeerAddrTable 1 } 1283 RserpoolENRPPeerAddrTableEntry ::= SEQUENCE { 1284 rserpoolENRPPeerAddrTableIndex Unsigned32, 1285 rserpoolENRPPeerL3Type InetAddressType, 1286 rserpoolENRPPeerL3Addr InetAddress } 1288 rserpoolENRPPeerAddrTableIndex OBJECT-TYPE 1289 SYNTAX Unsigned32 (1..4294967295) 1290 MAX-ACCESS not-accessible 1291 STATUS current 1292 DESCRIPTION 1293 "A unique identifier for the IP address of a peer ENRP 1294 transport endpoint." 1295 ::= { rserpoolENRPPeerAddrTableEntry 1 } 1297 rserpoolENRPPeerL3Type OBJECT-TYPE 1298 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 1299 MAX-ACCESS read-only 1300 STATUS current 1301 DESCRIPTION 1302 "The network-layer protocol (IPv4 or IPv6) of an IP address 1303 of a peer ENRP transport endpoint." 1304 REFERENCE 1305 "RFC 5353 defines the ENRP protocol." 1306 ::= { rserpoolENRPPeerAddrTableEntry 2 } 1308 rserpoolENRPPeerL3Addr OBJECT-TYPE 1309 SYNTAX InetAddress (SIZE(4|16)) 1310 MAX-ACCESS read-only 1311 STATUS current 1312 DESCRIPTION 1313 "The IP address of a peer ENRP transport endpoint. The type 1314 of this address is given in rserpoolENRPPeerL3Type." 1315 REFERENCE 1316 "RFC 5353 defines the ENRP protocol." 1317 ::= { rserpoolENRPPeerAddrTableEntry 3 } 1319 -- ################################################################ 1320 -- #### Pool Elements Section #### 1321 -- ################################################################ 1323 -- ## Definition of the pool element table ######################## 1324 rserpoolPETable OBJECT-TYPE 1325 SYNTAX SEQUENCE OF RserpoolPEEntry 1326 MAX-ACCESS not-accessible 1327 STATUS current 1328 DESCRIPTION 1329 "The table listing of pool elements." 1330 ::= { rserpoolPoolElements 1 } 1332 rserpoolPEEntry OBJECT-TYPE 1333 SYNTAX RserpoolPEEntry 1334 MAX-ACCESS not-accessible 1335 STATUS current 1336 DESCRIPTION 1337 "A pool element in the table listing of pool elements." 1338 INDEX { rserpoolPEIndex } 1339 ::= { rserpoolPETable 1 } 1341 RserpoolPEEntry ::= SEQUENCE { 1342 rserpoolPEIndex Unsigned32, 1343 rserpoolPEOperationScope RSerPoolOperationScopeTC, 1344 rserpoolPEPoolHandle RSerPoolPoolHandleTC, 1345 rserpoolPEIdentifier RserpoolPoolElementIdentifierTC, 1346 rserpoolPEDescription OCTET STRING, 1347 rserpoolPEUptime TimeTicks, 1348 rserpoolPEASAPTransportPort InetPortNumber, 1349 rserpoolPEUserTransportProto Unsigned32, 1350 rserpoolPEUserTransportPort InetPortNumber, 1351 rserpoolPEUserTransportUse RSerPoolTransportUseTypeTC, 1352 rserpoolPEPolicyID RSerPoolPolicyIdentifierTC, 1353 rserpoolPEPolicyDescription OCTET STRING, 1354 rserpoolPEPolicyWeight RSerPoolPolicyWeightTC, 1355 rserpoolPEPolicyLoad RSerPoolPolicyLoadTC, 1356 rserpoolPEPolicyLoadDeg RSerPoolPolicyLoadTC, 1357 rserpoolPERegistrationLife TimeTicks, 1358 rserpoolPEHomeENRPServer RSerPoolENRPServerIdentifierTC } 1360 rserpoolPEIndex OBJECT-TYPE 1361 SYNTAX Unsigned32 (1..4294967295) 1362 MAX-ACCESS not-accessible 1363 STATUS current 1364 DESCRIPTION 1365 "An integer to uniquely identify a pool element. Note, 1366 that uniqueness of a pool element identifier in the pool 1367 is not enforced, therefore this index is required here!" 1368 ::={ rserpoolPEEntry 1 } 1370 rserpoolPEOperationScope OBJECT-TYPE 1371 SYNTAX RSerPoolOperationScopeTC 1372 MAX-ACCESS read-only 1373 STATUS current 1374 DESCRIPTION 1375 "The operation scope of this pool element." 1376 REFERENCE 1377 "Section 1.2 of RFC 3237 defines the term operation scope." 1378 ::= { rserpoolPEEntry 2 } 1380 rserpoolPEPoolHandle OBJECT-TYPE 1381 SYNTAX RSerPoolPoolHandleTC 1382 MAX-ACCESS read-write 1383 STATUS current 1384 DESCRIPTION 1385 "The pool handle of this pool element. Changing this object 1386 will update the pool element's pool handle and result in a 1387 re-registration. 1389 This object SHOULD be maintained in a persistent manner." 1390 REFERENCE 1391 "Section 1.2 of RFC 3237 defines the term pool handle." 1392 ::={ rserpoolPEEntry 3 } 1394 rserpoolPEIdentifier OBJECT-TYPE 1395 SYNTAX RserpoolPoolElementIdentifierTC 1396 MAX-ACCESS read-only 1397 STATUS current 1398 DESCRIPTION 1399 "The pool element identifier of this pool element." 1400 REFERENCE 1401 "Section 3.10 of RFC 5354 defines the pool element identifier." 1402 ::={ rserpoolPEEntry 4 } 1404 rserpoolPEDescription OBJECT-TYPE 1405 SYNTAX OCTET STRING (SIZE (0..255)) 1406 MAX-ACCESS read-write 1407 STATUS current 1408 DESCRIPTION 1409 "A textual description of this pool element, e.g. its location 1410 and a contact address of its administrator. 1412 This object SHOULD be maintained in a persistent manner." 1413 ::= { rserpoolPEEntry 5 } 1415 rserpoolPEUptime OBJECT-TYPE 1416 SYNTAX TimeTicks 1417 MAX-ACCESS read-only 1418 STATUS current 1419 DESCRIPTION 1420 "The ENRP service uptime of this pool element." 1421 ::= { rserpoolPEEntry 6 } 1423 rserpoolPEASAPTransportPort OBJECT-TYPE 1424 SYNTAX InetPortNumber 1425 MAX-ACCESS read-only 1426 STATUS current 1427 DESCRIPTION 1428 "The SCTP port number of the ASAP endpoint of this pool element." 1430 REFERENCE 1431 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1432 which the port number is given here." 1433 ::= { rserpoolPEEntry 7 } 1435 rserpoolPEUserTransportProto OBJECT-TYPE 1436 SYNTAX Unsigned32 (0..255) 1437 MAX-ACCESS read-only 1438 STATUS current 1439 DESCRIPTION 1440 "The transport protocol number of the service endpoint 1441 of this pool element." 1442 REFERENCE 1443 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1444 which the transport protocol number is given here." 1445 ::= { rserpoolPEEntry 8 } 1447 rserpoolPEUserTransportPort OBJECT-TYPE 1448 SYNTAX InetPortNumber 1449 MAX-ACCESS read-only 1450 STATUS current 1451 DESCRIPTION 1452 "The transport protocol's port number of the service 1453 endpoint of this pool element." 1454 REFERENCE 1455 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1456 which the port number is given here." 1457 ::= { rserpoolPEEntry 9 } 1459 rserpoolPEUserTransportUse OBJECT-TYPE 1460 SYNTAX RSerPoolTransportUseTypeTC 1461 MAX-ACCESS read-only 1462 STATUS current 1463 DESCRIPTION 1464 "The transport use of the service endpoint of this pool element." 1465 REFERENCE 1466 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1467 which the transport use is given here." 1468 ::= { rserpoolPEEntry 10 } 1470 rserpoolPEPolicyID OBJECT-TYPE 1471 SYNTAX RSerPoolPolicyIdentifierTC 1472 MAX-ACCESS read-write 1473 STATUS current 1474 DESCRIPTION 1475 "The pool policy of this pool element. Changing this object 1476 will update the pool element's policy and result in a 1477 re-registration. 1479 This object SHOULD be maintained in a persistent manner." 1480 REFERENCE 1481 "Section 3.8 of RFC 5354 defines the Member Selection Policy 1482 Parameter of which the policy identifier is given here." 1483 ::= { rserpoolPEEntry 11 } 1485 rserpoolPEPolicyDescription OBJECT-TYPE 1486 SYNTAX OCTET STRING (SIZE (0..255)) 1487 MAX-ACCESS read-write 1488 STATUS current 1489 DESCRIPTION 1490 "The textual description of the pool policy of this pool element. 1492 This object SHOULD be maintained in a persistent manner." 1493 ::= { rserpoolPEEntry 12 } 1495 rserpoolPEPolicyWeight OBJECT-TYPE 1496 SYNTAX RSerPoolPolicyWeightTC 1497 MAX-ACCESS read-write 1498 STATUS current 1499 DESCRIPTION 1500 "The pool policy's weight parameter for this pool element. 1501 Changing this object will update the pool element's policy 1502 weight setting and result in a re-registration. 1504 This object SHOULD be maintained in a persistent manner." 1505 REFERENCE 1506 "Section 3.8 of RFC 5354 defines the Member Selection Policy 1507 Parameter of which the policy's weight parameter is given here." 1508 ::= { rserpoolPEEntry 13 } 1510 rserpoolPEPolicyLoad OBJECT-TYPE 1511 SYNTAX RSerPoolPolicyLoadTC 1512 MAX-ACCESS read-only 1513 STATUS current 1514 DESCRIPTION 1515 "The pool policy's load status for this pool element." 1516 REFERENCE 1517 "Section 3.8 of RFC 5354 defines the Member Selection Policy 1518 Parameter of which the policy's load parameter is given here." 1519 ::= { rserpoolPEEntry 14 } 1521 rserpoolPEPolicyLoadDeg OBJECT-TYPE 1522 SYNTAX RSerPoolPolicyLoadTC 1523 MAX-ACCESS read-write 1524 STATUS current 1525 DESCRIPTION 1526 "The pool policy's load degradation parameter for this pool 1527 element. Changing this object will update the pool element's 1528 load degradation setting and result in a re-registration. 1530 This object SHOULD be maintained in a persistent manner." 1531 REFERENCE 1532 "Section 3.8 of RFC 5354 defines the Member Selection Policy 1533 Parameter of which the policy's load degradation parameter is 1534 given here." 1535 ::= { rserpoolPEEntry 15 } 1537 rserpoolPERegistrationLife OBJECT-TYPE 1538 SYNTAX TimeTicks 1539 MAX-ACCESS read-write 1540 STATUS current 1541 DESCRIPTION 1542 "The registration life of this pool element. Changing this 1543 object will update the pool element's lifetime setting and 1544 result in a re-registration. 1546 This object SHOULD be maintained in a persistent manner." 1547 REFERENCE 1548 "Section 3.10 of RFC 5354 defines the Registration Life." 1549 ::= { rserpoolPEEntry 16 } 1551 rserpoolPEHomeENRPServer OBJECT-TYPE 1552 SYNTAX RSerPoolENRPServerIdentifierTC 1553 MAX-ACCESS read-only 1554 STATUS current 1555 DESCRIPTION 1556 "The ID of the home ENRP server of this pool element." 1557 REFERENCE 1558 "Section 3.10 of RFC 5354 defines the Home ENRP Server 1559 Identifier." 1560 ::= { rserpoolPEEntry 17 } 1562 -- ## Definition of the ASAP transport address list table ######### 1563 rserpoolPEASAPAddrTable OBJECT-TYPE 1564 SYNTAX SEQUENCE OF RserpoolPEASAPAddrTableEntry 1565 MAX-ACCESS not-accessible 1566 STATUS current 1567 DESCRIPTION 1568 "A table listing of all IP addresses of the ASAP transport 1569 endpoint." 1570 REFERENCE 1571 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1572 which the addresses are listed in this table." 1573 ::= { rserpoolPoolElements 2 } 1575 rserpoolPEASAPAddrTableEntry OBJECT-TYPE 1576 SYNTAX RserpoolPEASAPAddrTableEntry 1577 MAX-ACCESS not-accessible 1578 STATUS current 1579 DESCRIPTION 1580 "An IP address of the ASAP transport endpoint." 1581 REFERENCE 1582 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1583 which an address is contained by this entry." 1584 INDEX { 1585 rserpoolPEIndex, 1586 rserpoolPEASAPAddrTableIndex } 1587 ::= { rserpoolPEASAPAddrTable 1 } 1589 RserpoolPEASAPAddrTableEntry ::= SEQUENCE { 1590 rserpoolPEASAPAddrTableIndex Unsigned32, 1591 rserpoolPEASAPL3Type InetAddressType, 1592 rserpoolPEASAPL3Addr InetAddress } 1594 rserpoolPEASAPAddrTableIndex OBJECT-TYPE 1595 SYNTAX Unsigned32 (1..4294967295) 1596 MAX-ACCESS not-accessible 1597 STATUS current 1598 DESCRIPTION 1599 "A unique identifier for the IP address of an ASAP transport 1600 endpoint." 1601 ::= { rserpoolPEASAPAddrTableEntry 1 } 1603 rserpoolPEASAPL3Type OBJECT-TYPE 1604 SYNTAX InetAddressType { ipv4(1), ipv6(2) } 1605 MAX-ACCESS read-only 1606 STATUS current 1607 DESCRIPTION 1608 "The network-layer protocol (IPv4 or IPv6) of an IP address of 1609 an ASAP transport endpoint." 1610 REFERENCE 1611 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1612 which the network-layer protocol number is given here." 1613 ::= { rserpoolPEASAPAddrTableEntry 2 } 1615 rserpoolPEASAPL3Addr OBJECT-TYPE 1616 SYNTAX InetAddress (SIZE(4|16)) 1617 MAX-ACCESS read-only 1618 STATUS current 1619 DESCRIPTION 1620 "The IP address of an ASAP transport endpoint. The type of 1621 this address is given in rserpoolPEASAPL3Type." 1622 REFERENCE 1623 "Section 3.10 of RFC 5354 defines the ASAP Transport Parameter of 1624 which the network-layer address (IPv4 or IPv6) is given here." 1625 ::= { rserpoolPEASAPAddrTableEntry 3 } 1627 -- ## Definition of the user transport address list table ######### 1628 rserpoolPEUserAddrTable OBJECT-TYPE 1629 SYNTAX SEQUENCE OF RserpoolPEUserAddrTableEntry 1630 MAX-ACCESS not-accessible 1631 STATUS current 1632 DESCRIPTION 1633 "A table listing of all IP addresses of the user 1634 transport endpoint." 1635 REFERENCE 1636 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1637 which the addresses are listed in this table." 1638 ::= { rserpoolPoolElements 6 } 1640 rserpoolPEUserAddrTableEntry OBJECT-TYPE 1641 SYNTAX RserpoolPEUserAddrTableEntry 1642 MAX-ACCESS not-accessible 1643 STATUS current 1644 DESCRIPTION 1645 "An IP address of the user transport endpoint." 1646 REFERENCE 1647 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1648 which an address is contained by this entry." 1649 INDEX { 1650 rserpoolPEIndex, 1651 rserpoolPEUserAddrTableIndex } 1652 ::= { rserpoolPEUserAddrTable 1 } 1654 RserpoolPEUserAddrTableEntry ::= SEQUENCE { 1655 rserpoolPEUserAddrTableIndex Unsigned32, 1656 rserpoolPEUserL3Type InetAddressType, 1657 rserpoolPEUserL3Addr InetAddress, 1658 rserpoolPEUserL3Opaque RSerPoolOpaqueAddressTC } 1660 rserpoolPEUserAddrTableIndex OBJECT-TYPE 1661 SYNTAX Unsigned32 (1..4294967295) 1662 MAX-ACCESS not-accessible 1663 STATUS current 1664 DESCRIPTION 1665 "A unique identifier for the IP address of an user transport 1666 endpoint." 1667 ::= { rserpoolPEUserAddrTableEntry 1 } 1669 rserpoolPEUserL3Type OBJECT-TYPE 1670 SYNTAX InetAddressType { unknown(0), ipv4(1), ipv6(2) } 1671 MAX-ACCESS read-only 1672 STATUS current 1673 DESCRIPTION 1674 "The network-layer protocol of an IP address of an user transport 1675 endpoint. Set to unknown for opaque address." 1676 REFERENCE 1677 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1678 which the network-layer protocol number is given here." 1679 ::= { rserpoolPEUserAddrTableEntry 2 } 1681 rserpoolPEUserL3Addr OBJECT-TYPE 1682 SYNTAX InetAddress (SIZE(0|4|16)) 1683 MAX-ACCESS read-only 1684 STATUS current 1685 DESCRIPTION 1686 "The IP address of an user transport endpoint. The type of 1687 this address is given in rserpoolPEUserL3Addr." 1688 REFERENCE 1689 "Section 3.10 of RFC 5354 defines the User Transport Parameter of 1690 which the network-layer address (IPv4 or IPv6) is given here." 1691 ::= { rserpoolPEUserAddrTableEntry 3 } 1693 rserpoolPEUserL3Opaque OBJECT-TYPE 1694 SYNTAX RSerPoolOpaqueAddressTC 1695 MAX-ACCESS read-only 1696 STATUS current 1697 DESCRIPTION 1698 "The opaque address of an user transport endpoint." 1699 REFERENCE 1700 "Section 3.16 of RFC 5354 defines the opaque transport address." 1701 ::= { rserpoolPEUserAddrTableEntry 4 } 1703 -- ################################################################ 1704 -- #### Pool Users Section #### 1705 -- ################################################################ 1707 -- ## Definition of the pool user table ########################### 1708 rserpoolPUTable OBJECT-TYPE 1709 SYNTAX SEQUENCE OF RserpoolPUEntry 1710 MAX-ACCESS not-accessible 1711 STATUS current 1712 DESCRIPTION 1713 "The table listing of pool users." 1714 ::= { rserpoolPoolUsers 1 } 1716 rserpoolPUEntry OBJECT-TYPE 1717 SYNTAX RserpoolPUEntry 1718 MAX-ACCESS not-accessible 1719 STATUS current 1720 DESCRIPTION 1721 "A pool user in the table listing of pool users." 1722 INDEX { rserpoolPUIndex } 1723 ::= { rserpoolPUTable 1 } 1725 RserpoolPUEntry ::= SEQUENCE { 1726 rserpoolPUIndex Unsigned32, 1727 rserpoolPUOperationScope RSerPoolOperationScopeTC, 1728 rserpoolPUPoolHandle RSerPoolPoolHandleTC, 1729 rserpoolPUDescription OCTET STRING, 1730 rserpoolPUUptime TimeTicks } 1732 rserpoolPUIndex OBJECT-TYPE 1733 SYNTAX Unsigned32 (1..4294967295) 1734 MAX-ACCESS not-accessible 1735 STATUS current 1736 DESCRIPTION 1737 "An integer to uniquely identify a pool user." 1738 ::= { rserpoolPUEntry 1 } 1740 rserpoolPUOperationScope OBJECT-TYPE 1741 SYNTAX RSerPoolOperationScopeTC 1742 MAX-ACCESS read-only 1743 STATUS current 1744 DESCRIPTION 1745 "The operation scope of this pool user." 1746 REFERENCE 1747 "Section 1.2 of RFC 3237 defines the term operation scope." 1748 ::= { rserpoolPUEntry 2 } 1750 rserpoolPUPoolHandle OBJECT-TYPE 1751 SYNTAX RSerPoolPoolHandleTC 1752 MAX-ACCESS read-write 1753 STATUS current 1754 DESCRIPTION 1755 "The pool handle of this pool user. Changing this object 1756 will update the pool user's pool handle for all future 1757 sessions. 1759 This object SHOULD be maintained in a persistent manner." 1760 REFERENCE 1761 "Section 1.2 of RFC 3237 defines the term pool handle." 1762 ::={ rserpoolPUEntry 3 } 1764 rserpoolPUDescription OBJECT-TYPE 1765 SYNTAX OCTET STRING (SIZE (0..255)) 1766 MAX-ACCESS read-write 1767 STATUS current 1768 DESCRIPTION 1769 "A textual description of this pool user, e.g. its location 1770 and a contact address of its administrator. 1772 This object SHOULD be maintained in a persistent manner." 1773 ::= { rserpoolPUEntry 4 } 1775 rserpoolPUUptime OBJECT-TYPE 1776 SYNTAX TimeTicks 1777 MAX-ACCESS read-only 1778 STATUS current 1779 DESCRIPTION 1780 "The ENRP service uptime of this pool user." 1781 ::= { rserpoolPUEntry 5 } 1783 -- ## MIB conformance and compliance ############################## 1784 rserpoolMIBCompliances OBJECT IDENTIFIER ::= { 1785 rserpoolMIBConformance 1 1786 } 1788 rserpoolMIBGroups OBJECT IDENTIFIER ::= { 1789 rserpoolMIBConformance 2 1790 } 1792 rserpoolMIBCompliance MODULE-COMPLIANCE 1793 STATUS current 1794 DESCRIPTION 1795 "The compliance statement for SNMP entities which implement 1796 RSerPool." 1797 MODULE 1798 MANDATORY-GROUPS { 1799 rserpoolENRPGroup, 1800 rserpoolPEGroup, 1801 rserpoolPUGroup } 1802 ::= { rserpoolMIBCompliances 1 } 1804 rserpoolENRPGroup OBJECT-GROUP 1805 OBJECTS { 1806 rserpoolENRPOperationScope, 1807 rserpoolENRPIdentifier, 1808 rserpoolENRPDescription, 1809 rserpoolENRPUptime, 1810 rserpoolENRPPort, 1811 rserpoolENRPASAPAnnouncePort, 1812 rserpoolENRPASAPAnnounceAddr, 1813 rserpoolENRPASAPAnnounceAddrType, 1814 rserpoolENRPENRPAnnounceAddrType, 1815 rserpoolENRPENRPAnnouncePort, 1816 rserpoolENRPENRPAnnounceAddr, 1818 rserpoolENRPPoolHandle, 1819 rserpoolENRPPoolElementID, 1821 rserpoolENRPASAPTransportPort, 1822 rserpoolENRPUserTransportProto, 1823 rserpoolENRPUserTransportUse, 1824 rserpoolENRPUserTransportPort, 1825 rserpoolENRPPolicyID, 1826 rserpoolENRPPolicyDescription, 1827 rserpoolENRPPolicyWeight, 1828 rserpoolENRPPolicyLoad, 1829 rserpoolENRPPolicyLoadDeg, 1830 rserpoolENRPRegistrationLife, 1831 rserpoolENRPHomeENRPServer, 1833 rserpoolENRPASAPL3Type, 1834 rserpoolENRPASAPL3Addr, 1836 rserpoolENRPUserL3Type, 1837 rserpoolENRPUserL3Addr, 1838 rserpoolENRPUserL3Opaque, 1840 rserpoolENRPENRPL3Type, 1841 rserpoolENRPENRPL3Addr, 1843 rserpoolENRPPeerIdentifier, 1844 rserpoolENRPPeerPort, 1845 rserpoolENRPPeerLastHeard, 1846 rserpoolENRPPeerL3Type, 1847 rserpoolENRPPeerL3Addr } 1848 STATUS current 1849 DESCRIPTION 1850 "The group contains all ENRP server instances 1851 running on the system" 1852 ::= { rserpoolMIBGroups 1 } 1854 rserpoolPEGroup OBJECT-GROUP 1855 OBJECTS { 1856 rserpoolPEOperationScope, 1857 rserpoolPEPoolHandle, 1858 rserpoolPEIdentifier, 1859 rserpoolPEDescription, 1860 rserpoolPEUptime, 1861 rserpoolPEASAPTransportPort, 1862 rserpoolPEUserTransportProto, 1863 rserpoolPEUserTransportPort, 1864 rserpoolPEUserTransportUse, 1865 rserpoolPEPolicyID, 1866 rserpoolPEPolicyDescription, 1867 rserpoolPEPolicyWeight, 1868 rserpoolPEPolicyLoad, 1869 rserpoolPEPolicyLoadDeg, 1870 rserpoolPERegistrationLife, 1871 rserpoolPEHomeENRPServer, 1873 rserpoolPEASAPL3Type, 1874 rserpoolPEASAPL3Addr, 1876 rserpoolPEUserL3Type, 1877 rserpoolPEUserL3Addr, 1878 rserpoolPEUserL3Opaque } 1879 STATUS current 1880 DESCRIPTION 1881 "The group contains all pool element instances 1882 running on the system" 1883 ::= { rserpoolMIBGroups 2 } 1885 rserpoolPUGroup OBJECT-GROUP 1886 OBJECTS { rserpoolPUOperationScope, 1887 rserpoolPUPoolHandle, 1888 rserpoolPUDescription, 1889 rserpoolPUUptime } 1890 STATUS current 1891 DESCRIPTION 1892 "The group contains all pool user instances 1893 running on the system" 1894 ::= { rserpoolMIBGroups 3 } 1896 END 1898 7. Operational Considerations 1900 The RSerPool MIB is an experimental track MIB module, since the 1901 RSerPool documents are Experimental RFCs. 1903 8. Security Considerations 1905 There are a number of management objects defined in this MIB module 1906 with a MAX-ACCESS clause of read-write and/or read-create. Such 1907 objects may be considered sensitive or vulnerable in some network 1908 environments. The support for SET operations in a non-secure 1909 environment without proper protection can have a negative effect on 1910 network operations. These are the tables and objects and their 1911 sensitivity/vulnerability: 1913 rserpoolENRPDescription (textual description change) 1915 rserpoolPEPoolHandle (pool handle of pool element change, similar 1916 to ASAP) 1918 rserpoolPEDescription (textual description change) 1920 rserpoolPEPolicyID (pool element ID change, similar to ASAP) 1922 rserpoolPEPolicyDescription (textual description change) 1924 rserpoolPEPolicyWeight (policy weight change, similar to ASAP) 1926 rserpoolPEPolicyLoadDeg (policy load degradation change, similar 1927 to ASAP) 1929 rserpoolPERegistrationLife (registration lifetime change, similar 1930 to ASAP) 1932 rserpoolPUPoolHandle (pool handle of accessed pool change, similar 1933 to ASAP) 1935 rserpoolPUDescription (textual description change) 1937 The security implications of changing these items are similar to 1938 changes via ASAP; the corresponding security implications are 1939 described in the threats document [RFC5355]. Modifying the textual 1940 descriptions of components may result in wrong administrator 1941 decisions upon malicious information. 1943 Some of the readable objects in this MIB module (i.e., objects with a 1944 MAX-ACCESS other than not-accessible) may be considered sensitive or 1945 vulnerable in some network environments. It is thus important to 1946 control even GET and/or NOTIFY access to these objects and possibly 1947 to even encrypt the values of these objects when sending them over 1948 the network via SNMP. Read access reveals the same information which 1949 is also available by ASAP and ENRP access. The security implications 1950 of these two protocols are explained in detail by the threats 1951 document [RFC5355]. 1953 SNMP versions prior to SNMPv3 did not include adequate security. 1954 Even if the network itself is secure (for example by using IPsec), 1955 even then, there is no control as to who on the secure network is 1956 allowed to access and GET/SET (read/change/create/delete) the objects 1957 in this MIB module. 1959 It is RECOMMENDED that implementers consider the security features as 1960 provided by the SNMPv3 framework (see [RFC3410], section 8), 1961 including full support for the SNMPv3 cryptographic mechanisms (for 1962 authentication and privacy). 1964 Further, deployment of SNMP versions prior to SNMPv3 is NOT 1965 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to 1966 enable cryptographic security. It is then a customer/operator 1967 responsibility to ensure that the SNMP entity giving access to an 1968 instance of this MIB module is properly configured to give access to 1969 the objects only to those principals (users) that have legitimate 1970 rights to indeed GET or SET (change/create/delete) them. 1972 9. IANA Considerations 1974 The MIB module in this document uses the following IANA-assigned 1975 OBJECT IDENTIFIER values recorded in the SMI Numbers registry: 1977 Descriptor OBJECT IDENTIFIER Value 1978 ---------- ----------------------- 1979 rserpoolMIB { experimental XXX } 1981 Editor's Note (to be removed prior to publication): the IANA is 1982 requested to assign a value for XXX under the experimental subtree 1983 and to record the assignment in the SMI Numbers registry. When the 1984 assignment has been made, the RFC Editor is asked to replace XXX 1985 (here and in the MIB module) with the assigned value and to remove 1986 this note. 1988 10. Acknowledgments 1990 The authors would like to express a special note of thanks to Phillip 1991 Conrad and Kevin Pinzhoffer for their efforts in the early formation 1992 of this draft. Furthermore, the authors would like to thank Bert 1993 Wijnen and Dan Romascanu for their valuable comments on this 1994 document. Finally, the authors would like to thank Nihad Cosic, Dirk 1995 Hoffstadt, Michael Kohnen, Jobin Pulinthanath, Randall Stewart, 1996 Michael Tuexen and Xing Zhou for their support. 1998 11. References 2000 11.1. Normative References 2002 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 2003 Requirement Levels", BCP 14, RFC 2119, March 1997. 2005 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 2006 Schoenwaelder, Ed., "Structure of Management Information 2007 Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. 2009 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 2010 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 2011 STD 58, RFC 2579, April 1999. 2013 [RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder, 2014 "Conformance Statements for SMIv2", STD 58, RFC 2580, 2015 April 1999. 2017 [RFC4001] Daniele, M., Haberman, B., Routhier, S., and J. 2018 Schoenwaelder, "Textual Conventions for Internet Network 2019 Addresses", RFC 4001, February 2005. 2021 [RFC5352] Stewart, R., Xie, Q., Stillman, M., and M. Tuexen, 2022 "Aggregate Server Access Protocol (ASAP)", RFC 5352, 2023 September 2008. 2025 [RFC5353] Xie, Q., Stewart, R., Stillman, M., Tuexen, M., and A. 2026 Silverton, "Endpoint Handlespace Redundancy Protocol 2027 (ENRP)", RFC 5353, September 2008. 2029 [RFC5354] Stewart, R., Xie, Q., Stillman, M., and M. Tuexen, 2030 "Aggregate Server Access Protocol (ASAP) and Endpoint 2031 Handlespace Redundancy Protocol (ENRP) Parameters", 2032 RFC 5354, September 2008. 2034 [RFC5356] Dreibholz, T. and M. Tuexen, "Reliable Server Pooling 2035 Policies", RFC 5356, September 2008. 2037 11.2. Informative References 2039 [RFC3237] Tuexen, M., Xie, Q., Stewart, R., Shore, M., Ong, L., 2040 Loughney, J., and M. Stillman, "Requirements for Reliable 2041 Server Pooling", RFC 3237, January 2002. 2043 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 2044 "Introduction and Applicability Statements for Internet- 2045 Standard Management Framework", RFC 3410, December 2002. 2047 [RFC5351] Lei, P., Ong, L., Tuexen, M., and T. Dreibholz, "An 2048 Overview of Reliable Server Pooling Protocols", RFC 5351, 2049 September 2008. 2051 [RFC5355] Stillman, M., Gopal, R., Guttman, E., Sengodan, S., and M. 2052 Holdrege, "Threats Introduced by Reliable Server Pooling 2053 (RSerPool) and Requirements for Security in Response to 2054 Threats", RFC 5355, September 2008. 2056 [Dre2006] Dreibholz, T., "Reliable Server Pooling -- Evaluation, 2057 Optimization and Extension of a Novel IETF Architecture", 2058 Ph.D. Thesis University of Duisburg-Essen, Faculty of 2059 Economics, Institute for Computer Science and Business 2060 Information Systems, URL: http:// 2061 duepublico.uni-duisburg-essen.de/servlets/DerivateServlet/ 2062 Derivate-16326/Dre2006-final.pdf, March 2007. 2064 [LCN2005] Dreibholz, T. and E. Rathgeb, "On the Performance of 2065 Reliable Server Pooling Systems", Proceedings of the 30th 2066 IEEE Local Computer Networks Conference, November 2005. 2068 [IJHIT2008] 2069 Dreibholz, T. and E. Rathgeb, "An Evalulation of the Pool 2070 Maintenance Overhead in Reliable Server Pooling Systems", 2071 International Journal of Hybrid Information Technology 2072 (IJHIT) Volume 1, Number 2, April 2008. 2074 [RSerPoolPage] 2075 Dreibholz, T., "Thomas Dreibholz's RSerPool Page", 2076 URL: http://tdrwww.iem.uni-due.de.de/dreibholz/rserpool/. 2078 [SNMPMIBS] 2079 Perkins, D. and E. McGinnis, "Understanding SNMP MIBs", 2080 1997. 2082 Authors' Addresses 2084 Thomas Dreibholz 2085 University of Duisburg-Essen, Institute for Experimental Mathematics 2086 Ellernstrasse 29 2087 45326 Essen, Nordrhein-Westfalen 2088 Germany 2090 Phone: +49-201-1837637 2091 Fax: +49-201-1837673 2092 Email: dreibh@iem.uni-due.de 2093 URI: http://www.iem.uni-due.de/~dreibh/ 2095 Jaiwant Mulik 2096 Delaware State University 2097 CIS Department 2098 Room 306A, Science Center North 2099 1200 N. DuPont Hwy 2100 Dover, DE 19904 2101 USA 2103 Phone: +1-302-857-7910 2104 Fax: +1-302-857-6552 2105 Email: jaiwant@mulik.com 2106 URI: http://netlab.cis.desu.edu