Network Working Group J. Mulik
Internet-Draft P. Conrad
Expires: May 14, 2002 K. Pinzhoffer
Temple University
November 13, 2001
Reliable Server Pooling : Management Information Base using SMIv2
draft-mulik-rserpool-mib-00.txt
Status of this Memo
This document is an Internet-Draft and is in full conformance with
all provisions of Section 10 of RFC2026.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at http://
www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on May 14, 2002.
Copyright Notice
Copyright (C) The Internet Society (2001). All Rights Reserved.
Abstract
RserPool [1] is a framework to provide reliable server pooling. This
document defines a SMIv2 compliant Management Information Base (MIB)
providing access to managed object in an RSerPool implementation.
Mulik, et al. Expires May 14, 2002 [Page 1]
Internet-Draft RSerPool MIB November 2001
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Structure of the MIB . . . . . . . . . . . . . . . . . . . . . 4
2.1 Access to managed objects on an ENRP nameserver . . . . . . . 5
2.2 Access to managed objects on Pool Elements . . . . . . . . . . 6
3. Definitions . . . . . . . . . . . . . . . . . . . . . . . . . 7
4. Security Considerations . . . . . . . . . . . . . . . . . . . 13
5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 14
References . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . 15
Full Copyright Statement . . . . . . . . . . . . . . . . . . . 17
Mulik, et al. Expires May 14, 2002 [Page 2]
Internet-Draft RSerPool MIB November 2001
1. Introduction
This memo defines a Management Information Base (MIB) module which
describes managed objects for RserPool implementations. The MIB
defined in this memo is described using the Structure of Management
Information version 2, as defined in RFC1902 [3], RFC1903 [4], and
RFC1904 [5].
Mulik, et al. Expires May 14, 2002 [Page 3]
Internet-Draft RSerPool MIB November 2001
2. Structure of the MIB
The following diagram illustrates the structure of the MIB.
Structure of MIB
rserpoolMIB
|
+----------------+-------------------+
| |
nameserver poolElements
| |
|--poolHandleCount |--poolHandleCount
| |
|--poolHandleTable |--poolHandleTable
| | | |
| +--poolHandleEntry | +--poolHandleEntry
| | | |
| |--poolHandleIndex | |--poolHandleIndex
| | | |
| |--poolElementCount | |--poolElementCount
| | | |
| +--poolHandle | +--poolHandle
| |
| |
|--poolElementTable |--poolElementTable
| | | |
| +--poolElementEntry | +--poolElementEntry
| | | |
| |--poolElementIndex | |--poolElementIndex
| | | |
| |--poolElementIPAddrCount | |--poolElementIPAddrCount
| | | |
| |--poolElementHostname | |--poolElementHostname
| | | |
| |--policyType | |--policyType
| | | |
| |--policyValue | |--policyValue
| | | |
| |--noOfRequests | |--noOfRequests
| | | |
| |--noOfRequestsInQueue | |--noOfRequestsInQueue
| | | |
| |--SCTPPort | |--SCTPPort
| | | |
| +--uptimePE | +--uptimePE
| |
Mulik, et al. Expires May 14, 2002 [Page 4]
Internet-Draft RSerPool MIB November 2001
|--addrListTable +--addrListTable
| | |
| +--addrListTableEntry +--addrListTableEntry
| | |
| |--addrListTableIndex |--addrListTableIndex
| | |
| +--hostIPAddress +--hostIPAddress
|
+--uptimeNS
As the figure shows, the MIB is in two main branches. The first
branch, "nameserver" is used to access managed objects at an ENRP
server. The second branch, "poolElements" is used to access managed
objects in the set of Pool Elements that are running on a given host.
In fact, the structure of the two branches is identical, except for
one detail: the nameserver branch has an extra element called
uptimeNS, which indicates the uptime of the ENRP server process
itself. We now proceed with a separate description of the two
branches. Because the two branches are so similar, we describe only
the first branch in detail, and provide a summary description of the
second branch.
2.1 Access to managed objects on an ENRP nameserver
The first branch describes managed objects at an ENRP nameserver.
Any given ENRP server will, at a certain moment in time, have
registration information for a set of active poolHandles. Each of
these poolHandles in turn may have a list of poolElements that are
registered under that poolHandle. To allow this information to be
retrieved via SNMP, the nameserver branch of the RSerPool MIB uses
the table-in-table technique described in [2]. Specifically, the
nameserver branch creates three levels of nesting, as indicated in
the following diagram:
Nesting of Nameserver Branch
Nesting Structure:
Level 1: poolHandleTable
Level 2: poolElementTable
Level 3: addrListTable
The nameserver branch contains five elements. The first element is
the poolHandleCount, which indicates the total number of server pools
Mulik, et al. Expires May 14, 2002 [Page 5]
Internet-Draft RSerPool MIB November 2001
currently registered with this name server. It is mainly used as a
means of indexing into the poolHandleTable, which is the second
element on this branch. The poolHandleTable contains a single entry
for each poolHandle that is currently registered. Each "conceptual
row" in the poolHandleTable consists of a poolHandleEntry, with three
elements: a poolHandleIndex, a poolElementCount, and an OCTET STRING
representation of the pool handle itself. The poolElementCount is
the number of pool elements registered with this pool handle. The
poolHandleIndex is simply an integer that is used to index into the
poolHandleTable and the poolElementTable. The value of this integer
is between zero and (poolHandleCount - 1). Note that the value of
poolHandleIndex is defined as "not-accessible" in the MAX-ACCESS
clause; this is a standard technique used when defining a table-in-
table data structure. The third element on the nameserver branch is
the poolElementTable. Because the poolElementTable is the "inner"
table of the table-in-table structure, its index consists of a pair,
as indicated in the clause "INDEX { poolHandleIndex, poolElementIndex
}". The fourth element of the nameserver branch takes the nesting to
one additional level, listing the various IP addresses associated
with a particular poolElement, and thus is indexed by a triple:
"INDEX { poolHandleIndex, poolElementIndex, addrListTableIndex }".
The fifth and final element on the nameserver branch is the uptimeNS,
which simply provides the uptime of the ENRP server since the last
restart of the ENRP server process.
2.2 Access to managed objects on Pool Elements
Note that on a given host, there may be an ENRP server process along
with a set of pool element processes. The nameserver branch
provides access to information about pool elements that has been
communicated to an ENRP server via the ASAP protocol. By contrast,
the "poolElements" branch of the MIB provides direct access to
managed objects in the pool elements themselves. It is anticipated
that a manager may want to query the pool elements directly when
investigating network problems related to communication between an
ENRP server and a pool element. Any given host may have, at a
certain point in time, several active pool element processes. These
processes might or might not all have unique poolHandles. Clearly,
it is feasible that a given host may be running multiple servers,
each with a separate poolHandle. What may be less obvious is that
there may also be multiple servers with the same poolhandle;
consider, for example, a host with multiple CPUs that might have one
server process per CPU, all providing the same service and thus
sharing the same pool handle, but with distinct poolElement
characteristics such as load, SCTPPort, policy value, etc.
Therefore, as on the nameserver branch, the table-in-table technique
is indicated. For simplicity, we use the exact same structure.
Mulik, et al. Expires May 14, 2002 [Page 6]
Internet-Draft RSerPool MIB November 2001
3. Definitions
RSERPOOL-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, TimeTicks, Unsigned32
FROM SNMPv2-SMI
rserpoolMIB MODULE-IDENTITY
LAST-UPDATED "200111120000Z"
ORGANIZATION "Netlab, TEMPLE UNIVERSITY"
CONTACT-INFO
JAIWANT-MULIK PHILLIP-CONRAD
KEVIN-PINZHOFFER
Postal: 1805, N Broad St.
Philadelphia, PA
USA 19121
Phones: +1 215 204 7910
Emails: jmulik@temple.edu
conrad@acm.org
kpinzhof@temple.edu
DESCRIPTION
"The MIB module for managing a RserPool implementation"
::= { xxxx } -- IANA assigned value
-- Top level definitions
nameServer OBJECT IDENTIFIER ::= { rserpoolMIB 1 }
poolElements OBJECT IDENTIFIER ::= { rserpoolMIB 2 }
-- Definition of the pool handle table
poolHandleCount OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of pool handles supported by this
name server"
::= { nameserver 1 }
poolHandleTable OBJECT-TYPE
SYNTAX SEQUENCE OF poolHandleEntry
Mulik, et al. Expires May 14, 2002 [Page 7]
Internet-Draft RSerPool MIB November 2001
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The conceptual table listing the pool handles served
by this name server"
::= { nameServer 2 }
poolHandleEntry OBJECT-TYPE
SYNTAX PoolHandleEntry
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The conceptual row in poolHandleTable."
INDEX { poolHandleIndex }
::= { poolHandleTable 1 }
PoolHandleEntry ::= SEQUENCE {
poolHandleIndex Unsigned32,
poolElementCount Unsigned32,
poolHandle OCTET STRING }
poolHandleIndex OBJECT-TYPE
SYNTAX UNSIGNED32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Index to the poolHandleTable. This value is between,
0 and (poolHandleCount-1)"
::= { poolHandleEntry 1}
poolElementCount OBJECT-TYPE
SYNTAX UNSIGNED32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of pool elements that belong to this
pool handle"
::= { poolHandleEntry 2 }
poolHandle OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The pool handle of this row"
::= { poolHandleEntry 3 }
Mulik, et al. Expires May 14, 2002 [Page 8]
Internet-Draft RSerPool MIB November 2001
-- Definition of pool element table
poolElementTable OBJECT-TYPE
SYNTAX SEQUENCE OF poolElementEntry
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The conceptual table listing the PEs per pool handle"
::= { nameserver 3 }
poolElementEntry OBJECT-TYPE
SYNTAX PoolELementEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The conceptual row in poolElementTable. Note the
compound
index element. We are using the table-in-table idea
here."
INDEX { poolHandleIndex, poolElementIndex }
::= { poolElementTable 1 }
PoolElementEntry ::= SEQUENCE {
poolElementIndex Unsigned32,
poolElementIPAddressCount Unsigned32,
poolElementHostname OCTET STRING
policyType Unsigned32,
policyValue Unsigned32,
noOfRequests Unsigned32,
noOfRequestsInQueue Unsigned32,
sctpPort INTEGER,
upTimePE TimeTicks }
poolElementIndex OBJECT TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Indexes into the poolElementTable. This value is between,
0 and (poolElementCount-1) of the
corresponding poolHandleTable"
::={ poolElementEntry 1 }
poolElementIPAddressCount OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCCESS read-only
STATUS current
DESCRIPTION
"Counts the number of IP addresses assigned to a hostname"
::= { poolElementEntry 2 }
Mulik, et al. Expires May 14, 2002 [Page 9]
Internet-Draft RSerPool MIB November 2001
poolElementHostname OBJECT-TYPE
SYNTAX OCTET STRING
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Hostname of a pool element"
::= { poolElementEntry 3 }
policyType OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The policy type for this pool element"
::= { poolElementEntry 4 }
policyValue OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The policy value for this pool element"
::= { poolElementEntry 5
noOfRequests OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of service requests that this PE is currenly
processing"
::= { poolElementEntry 6}
noOfRequestsInQueue OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of service requests currently queued by the PE"
::= { poolElementEntry 7 }
sctpPort OBJECT-TYPE
SYNTAX INTEGER (0..65535)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The SCTP port from this pool elements PE parameter"
Mulik, et al. Expires May 14, 2002 [Page 10]
Internet-Draft RSerPool MIB November 2001
::= { poolElementEntry 8 }
upTimePE OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Time since last start of the PE"
::= { poolElementEntry 9 }
--- Definition of addresslist Table
addrListTable OBJECT TYPE
SYNTAX SEQUENCE OF addrListTableEntry
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This table holds all the IP addresses of a multi-homed
host"
::= { nameserver 4 }
addrListTableEntry OBJECT TYPE
SYNTAX AddrListTableEntry
MAX-ACCESS read-only
STATUS current
INDEX { poolHandleIndex, poolElementIndex,
addrListTableIndex }
Description
"A row in the addrList table"
::= { addrListTable 1 }
AddrListTableEntry ::= SEQUENCE {
addrListTableIndex Unsigned32,
hostIPAddress IpAddress }
addrListTableIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
"Indexes into the addrListTable. This values is between
0 and (poolElementIPAddressCount-1)."
::= { addrListTableEntry 1}
hostIPAddress OBJECT TYPE
SYNTAX IpAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
Mulik, et al. Expires May 14, 2002 [Page 11]
Internet-Draft RSerPool MIB November 2001
" The address column in the addrListTable "
::= { addrListTableEntry 2 }
--
uptimeNS OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Time since the last start of this service"
::= { nameserver 5 }
The definitions of the managed objects under the "poolElements"
branch are identical to those under the nameserver branch with the
single exception that the uptimeNS element is not present.
Therefore, for sake of brevity and to avoid inadvertant
inconsistencies due to typos, we omit the full elaboration of the
poolElement branch. However, we repeat for emphasis that the
semantics of the two branches are different, as noted earlier in this
memo.
Mulik, et al. Expires May 14, 2002 [Page 12]
Internet-Draft RSerPool MIB November 2001
4. Security Considerations
Security issues are not discussed in this memo.
Mulik, et al. Expires May 14, 2002 [Page 13]
Internet-Draft RSerPool MIB November 2001
5. IANA Considerations
IANA will need to assign an OID prefix for the RSerPool MIB.
Mulik, et al. Expires May 14, 2002 [Page 14]
Internet-Draft RSerPool MIB November 2001
References
[1] M. Tuexen et. al, , "Architecture for Reliable Server Pooling",
Internet-Draft work in progress, April 2001, <http://
www.ietf.org/internet-drafts/draft-ietf-rserpool-arch-00.txt>.
[2] Perkins, D. and E. McGinnis, "Understanding SNMP MIBs", 1997,
<http://www.ietf.org/internet-drafts/draft-ietf-rserpool-arch-
00.txt>.
[3] McCloghrie, K., Case, J., McCloghrie, K., Rose, M. and S.
Waldbusser, "Structure of Management Information for Version 2
of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
January 1996.
[4] McCloghrie, K., Case, J., Rose, M. and S. Waldbusser, "Textual
Conventions for Version 2 of the Simple Network Management
Protocol (SNMPv2)", RFC 1903, January 1996.
[5] McCloghrie, K., Case, J., Rose, M. and S. Waldbusser,
"Conformance Statements for Version 2 of the Simple Network
Management Protocol (SNMPv2)", RFC 1904, January 1996.
Authors' Addresses
Jaiwant Mulik
Temple University
CIS Department
Room 303, Computer Building (038-24)
1805 N. Broad St.
Philadelphia, PA 19122
US
Phone: +1 215 204 3197
EMail: jmulik@temple.edu
URI: http://unix.temple.edu/~jmulik
Mulik, et al. Expires May 14, 2002 [Page 15]
Internet-Draft RSerPool MIB November 2001
Phillip T. Conrad
Temple University
CIS Department
Room 303, Computer Building (038-24)
1805 N. Broad St.
Philadelphia, PA 19122
US
Phone: +1 215 204 7910
EMail: conrad@joda.cis.temple.edu
URI: http://www.cis.temple.edu/~conrad
Kevin Pinzhoffer
Temple University
CIS Department
Room 303, Computer Building (038-24)
1805 N. Broad St.
Philadelphia, PA 19122
US
Phone: +1 215 204 3197
EMail: kpinzhof@temple.edu
Mulik, et al. Expires May 14, 2002 [Page 16]
Internet-Draft RSerPool MIB November 2001
Full Copyright Statement
Copyright (C) The Internet Society (2001). All Rights Reserved.
This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain it
or assist in its implementation may be prepared, copied, published
and distributed, in whole or in part, without restriction of any
kind, provided that the above copyright notice and this paragraph are
included on all such copies and derivative works. However, this
document itself may not be modified in any way, such as by removing
the copyright notice or references to the Internet Society or other
Internet organizations, except as needed for the purpose of
developing Internet standards in which case the procedures for
copyrights defined in the Internet Standards process must be
followed, or as required to translate it into languages other than
English.
The limited permissions granted above are perpetual and will not be
revoked by the Internet Society or its successors or assigns.
This document and the information contained herein is provided on an
"AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Acknowledgement
Funding for the RFC Editor function is currently provided by the
Internet Society.
Mulik, et al. Expires May 14, 2002 [Page 17]