Internet Draft Information Store MIB April 22,1996
Definitions of Managed Objects for an Information Store
April 22, 1996
<draft-hazewinkel-ismib-00.txt>
Harrie Hazewinkel
University of Twente
hazewink@cs.utwente.nl
Eric van Hengstum
University of Twente
hengstum@cs.utwente.nl
Aiko Pras
University of Twente
pras@cs.utwente.nl
Status of this Memo
This document is an Internet-Draft. 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.''
To learn the current status of any Internet-Draft, please check
the ``1id-abstracts.txt'' listing contained in the Internet-
Drafts Shadow Directories on ds.internic.net (US East Coast),
nic.nordu.net (Europe), ftp.isi.edu (US West Coast), or
munnari.oz.au (Pacific Rim).
Expires October 22, 1996 [Page 1]
Internet Draft Information Store MIB April 22, 1996
1. Abstract
This draft defines a MIB for use with managing information stores.
The term "information store" is construed to mean any information
providing application, such as World Wide Web (WWW), File Transfer
Protocol (FTP), and Gopher. The information store is seen as the
application responsible for the information providing capabilities.
Expires October 22, 1996 [Page 2]
Internet Draft Information Store MIB April 22, 1996
2. The SNMPv2 Network Management Framework
The SNMPv2 Network Management Framework consists of four major
components. They are:
o STD 17, RFC 1213 [2] defines MIB-II, the core set of managed
objects for the Internet suite of protocols.
o RFC 1901 Introduction to Community-based SNMPv2
o RFC 1902 Structure of Management Information for Version 2 of
the Simple Network Management Protocol (SNMPv2)
o RFC 1903 Textual Conventions for Version 2 of the Simple
Network Management Protocol (SNMPv2)
o RFC 1904 Conformance Statements for Version 2 of the Simple
Network Management Protocol (SNMPv2)
o RFC 1907 Management Information Base for Version 2 of the
Simple Network Management Protocol (SNMPv2)
o RFC 1908 Coexistence between Version 1 and Version 2 of the
Internet-standard Network Management Framework
The Framework permits new objects to be defined for the purpose of
experimentation and evaluation.
2.1. Object Definitions
Managed objects are accessed via a virtual information store,
termed the Management Information Base or MIB. Objects in the MIB
are defined using the subset of Abstract Syntax Notation One
(ASN.1) defined in the SMI[1]. In particular, each object type is
named by an OBJECT IDENTIFIER, an administratively assigned name.
The object type together with an object instance serves to
uniquely identify a specific instantiation of the object. For
human convenience, we often use a textual string, termed the
object descriptor, to refer to the object type.
Expires October 22, 1996 [Page 3]
Internet Draft Information Store MIB April 22, 1996
3. Introduction.
The Information Store represents the information part of a World Wide
Web application. The name Information Store (IS) is strongly related
to the use of this part of the WWW application. Most WWW servers provide
information to users / customers (clients) of the WWW application. In
order to maintain and manage the provided information a specific MIB
module is defined. The Information Store MIB module specifies the
network management information of the WWW server, providing the
aforementioned information.
The work performed for this MIB is a result of a project executed
for the Centre of Earth Observations. It is not seen as complete,
but it should be a first step in an effort to manage the WWW. An
implementation of this MIB already exists. Due to the use of a
commercial development package it cannot be distributed. However,
a public domain version is now being developed.
4. Information Store MIB structure.
The Information Store MIB module structure contains the
following groups:
1. isGeneral,
2. isAccess,
3. isErrors, and
4. isDocuments.
4.1 General Group
The isGeneral group contains overall administrative data which
uniquely identifies the IS, and should be static for the Information
Store (IS). The network management information consists of the
administrative data uniquely identifying the IS. In addition to the
static data, such as the isContact object (a contact address for the
person responsible for the information provided by the IS), the
isGeneral group also contains the isTopicTable. The NMS user can use
this table to discover what kinds of information are provided by
the IS. It was originally intended to include an isLocation variable
in this group. This variable would have provided information on the
location of the IS, however, as this information is also contained
in the sysLocation of the system group it was omitted.
The general group contains also information of applications on which
the IS depends (such as database applications for search facilities).
The application dependency table provides that information. The
status of these applications is checked dynamically and the values
are related to the `process status' command of the UNIX environment.
Expires October 22, 1996 [Page 4]
Internet Draft Information Store MIB April 22, 1996
4.2 Access group
The access group contains network management information about the
network activity of the Information Store. The network activity is
described in an abstract manner in regard to the service which
transports the information.
This group provides network management information with the
following points of view:
1. general data containing totals for the information store,
2. domain data containing totals ordered by domains,
3. daily access data which contains totals for the last N days,
4. user data which contains information concerning the most
frequent and most recent users.
The general access data provides statistics relating to usage of
the IS. For example, the variables number of accesses
(isNumberOfAccesses) and the number of bytes in/ out
(isNumberOfBytesOut, isNumberOfBytesIn) are defined.
The isDomainTable breaks down accesses to the IS by Internet domain.
The NMS operator can thus discover the countries or groups regular
users of the IS belong. This on may be valuable, as an IS
administrator can decide whether mirror servers in certain domains
may be useful. Then long distance network traffic as well as the
server load could be reduced.
To see the number of hits for each day an isAccessOfLastNDaysTable
is defined. Together with a variable setting the total number of
days which can be traced backwards, this table provides information
on the number of accesses executed on the IS on a day to day basis.
The isDomainTable and isAccessOfLastNDaysTable provide useful
information on the number and sources of accesses to the IS,
however, it is equally important to know what information is
attracting Users to the IS. In support of this function, two tables
are defined. These tables are a most recent users table and a most
frequent users table. The combination of these tables should give
meaningful information of users and which information they access.
The isMostFrequentUser table is defined in a slightly different
fashion from the isMostRecentUser table. This is mainly because of
implementation aspects such as the amount of memory used to store
information relating to the IS users and the processing time to
generate the information. Details on every User who has accessed
the IS must be stored, because new accesses may give that User a
new place in the table. Therefore, the following solution was
adopted: the table is updated on initiative of the NMS, thus making
the NMS responsible for limiting the number of updates requested.
Expires October 22, 1996 [Page 5]
Internet Draft Information Store MIB April 22, 1996
The NMS requests an update by setting the refresh variable to the
value `false'. An Agent subprocess then processes the new information
and, on exiting, sets the refresh variable to the value `true'. The
subprocess also updates the time stamp variable indicating the date
and time when the table was last refreshed.
Besides these variables, the size of the table can also be set with
a size variable which has a value in the range of 0 to 128.
The isMostRecentUsers table provides information on which users are
the last ones who accessed the IS. The size of the table is limited
to at most 128 and can be set in a range of 0 to 128. The table is
indexed with the position of the User in the table, and contains
information giving the Users name, the time of last access, and
document that was accessed.
4.3 Error Group
The error group contains network management information about errors
which occurred during accesses of the IS. This group abstracts from
the network errors that occur, it only shows errors resulting from
information access. This group is defined as a table with an error
description, the number of occurrences of that error and the time at
which the error last occurred. The reason for defining this
information in a table is that an implementor of the MIB module can
simply add new errors to the table without changing the MIB module
definition.
4.4 Document Group
The document group contains the network management information about
the data which is provided by the Information Store. The information
is kept in a table containing the documents name, access rights,
size, type, and other features such as the number of accesses, time
of last update, and any associated errors. The isDocumentTable has
the same implementation constraints as the isMostFrequentNUserTable,
and is handled in a similar fashion, with TableSize, TableRefresh,
and TableData variables. It should be noted that (in the current
implementation) e isDocumentTable is populated from User accesses,
and thus documents which have not been accessed will not appear in
the table.
Expires October 22, 1996 [Page 6]
Internet Draft Information Store MIB April 22, 1996
5. Information Store MIB definitions
IS-MIB DEFINITIONS ::=
BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Counter32, TimeTicks, Integer32
FROM SNMPv2-SMI
TEXTUAL-CONVENTION, DisplayString, DateAndTime, TruthValue, TimeStamp
FROM SNMPv2-TC
MODULE-COMPLIANCE, OBJECT-GROUP
FROM SNMPv2-CONF;
isMIB MODULE-IDENTITY
LAST-UPDATED "9601251800Z"
ORGANIZATION "University Of Twente"
CONTACT-INFO
" Harrie Hazewinkel
Postal: Centre of Telematics and
Information Technology
University Of Twente
POBox 217
7500 AE Enschede
The Netherlands
phone : +31 53 4893746
E-mail: H.Hazewinkel@cs.utwente.nl
This document benefited greatly from the comments of
all participants in the CEO project for management of
World Wide Web Servers."
DESCRIPTION
"A MIB module for an Information Store.
An Information Store is the application from which
the information is retrieved on the World Wide Web."
::= { enterprises universityOfTwente(785) 4 }
isObjects OBJECT IDENTIFIER ::= { isMIB 1 }
isConformance OBJECT IDENTIFIER ::= { isMIB 2 }
isCompliances OBJECT IDENTIFIER ::= { isConformance 1 }
isGroups OBJECT IDENTIFIER ::= { isConformance 2 }
Expires October 22, 1996 [Page 7]
Internet Draft Information Store MIB April 22, 1996
MediaType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"This type should be representing the media types
which the information store makes available. The
media types are those recognized by the RFC 1700.
The value is a sum and is initially the value zero.
Then, for each media type, L, in the range 1 through
7, 2 raised to (L - 1) is added to the sum.
For example, a server which only supports video
would have a value of 64 (2^(7-1)). In
contrast, a server which is offering text and images
would have a value of 17 (2^(1-1) + 2^(5-1)).
Note that in the context of this media type,
values should be calculated accordingly:
1 text
2 multipart
3 message
4 application
5 image
6 audio
7 video"
SYNTAX INTEGER (0..127)
ApplResourceIdentifier ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"A distinguished name which contains a host on which
the application is running and the application's name."
SYNTAX DisplayString
AccessRights ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"A type with which access rights of a document is
described.
The rights are:
read-only permission
read-write permission
execute permission"
SYNTAX INTEGER {
read-only(1), read-write(2), execute-able(3)
}
Expires October 22, 1996 [Page 8]
Internet Draft Information Store MIB April 22, 1996
isGeneral OBJECT IDENTIFIER ::= { isObjects 1 }
isName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An administratively-assigned name for this
Information Store."
::= { isGeneral 1 }
-- Instrumentation : Config file
isOrganisation OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The textual identification of the organisation
responsible for the Information Store server.
For example, if the organisation which is offering
information of the Information Store is named
`Flintstones, Inc'. This value should have the
value of `Flintstones, Inc'."
::= { isGeneral 2 }
-- Instrumentation : Config file
isContact OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The textual identification of the contact person
for this Information Store server, together with
information on how to contact this person.
For example, when `Fred' of the `Flintstones, Inc'
is maintaining this Information Store, the value
should be `Fred@Flintstones'."
::= { isGeneral 3 }
-- Instrumentation : Config file
isLastInitialisation OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time the Information
Store was last initialized. If the Information Store
was last initialized prior to the initialization of
the network management subsystem, then this object
contains a zero value."
::= { isGeneral 4 }
-- Instrumentation : Config file
Expires October 22, 1996 [Page 9]
Internet Draft Information Store MIB April 22, 1996
isSupportedMediaTypes OBJECT-TYPE
SYNTAX MediaType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A value which indicates the set of media types that
this Information Store primarily offers."
::= { isGeneral 5 }
-- Instrumentation : Config file
isApplDependancyTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsApplDependancyEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table holding objects which apply to all different
kinds of applications provided by the Information
Store."
::= { isGeneral 6 }
-- Instrumentation : Config file
isApplDependancyEntry OBJECT-TYPE
SYNTAX IsApplDependancyEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry associated with an application."
INDEX {applIndex}
::= {isApplDependancyTable 1}
IsApplDependancyEntry ::= SEQUENCE {
isApplIndex INTEGER,
isApplResourceIdentifier ApplResourceIdentifier,
isApplProcessName DisplayString,
isApplVersion DisplayString,
isApplUptime TimeStamp,
isApplOperStatus INTEGER,
isApplLastChange TimeStamp,
isApplLastActivity TimeStamp,
isApplFailedActivities Counter32
}
isApplIndex OBJECT-TYPE
SYNTAX INTEGER (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index to uniquely identify the application
application."
::= {isApplDependancyEntry 1}
-- Instrumentation : Config file
Expires October 22, 1996 [Page 10]
Internet Draft Information Store MIB April 22, 1996
isApplResourceIdentifier OBJECT-TYPE
SYNTAX ApplResourceIdentifier
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The distinguished name of the host on which the
application is running and the application name."
::= {isApplDependancyEntry 2}
-- Instrumentation : Config file
isApplProcessName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The process name of the application."
::= {isApplDependancyEntry 3}
-- Instrumentation : Config file
isApplVersion OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The version of the application software."
::= {isApplDependancyEntry 4}
-- Instrumentation : Config file
isApplUptime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time the application
was last initialized. If the application was last
initialized prior to the last initialization of the
network management subsystem, then this object contains
a zero value."
::= {isApplDependancyEntry 5}
-- Instrumentation : Config file
Expires October 22, 1996 [Page 11]
Internet Draft Information Store MIB April 22, 1996
isApplOperStatus OBJECT-TYPE
SYNTAX INTEGER { running(1), sleeping(2),
runnable(3), idle(4),
zombie(5), traced(6),
sxbrkState(7), notFound(8) }
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the operational status of the network service
application. The values are related to the output
of the `ps'-command and the values are:
running: running on a processor.
sleeping: waiting for an event to complete.
runnable: on run queue.
idle: being created.
zombie: terminated and parent not
waiting.
traced: stopped by a signal because
parent is tracing it.
sxbrkState: waiting for more primary memory.
notFound: not found in process list."
::= {isApplDependancyEntry 6}
-- Instrumentation : Config file
isApplLastChange OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time the application
application entered its current operational state. If
the current state was entered prior to the last
initialization of the local network management
subsystem, then this object contains a zero value."
::= {isApplDependancyEntry 7 }
-- Instrumentation : Config file
isApplLastActivity OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime at the time this application
last performed some activity. If the last activity
occurred prior to the last initialization of the
application, then this object contains a zero value."
::= {isApplDependancyEntry 8 }
-- Instrumentation : Config file
Expires October 22, 1996 [Page 12]
Internet Draft Information Store MIB April 22, 1996
isApplFailedActivities OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number activities where the application
has failed, since application initialization."
::= {isApplDependancyEntry 9}
-- Instrumentation : Config file
isTopicTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsTopicEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table holding topics provided by this
Information Store."
::= { isGeneral 7 }
-- Instrumentation : Config file
isTopicEntry OBJECT-TYPE
SYNTAX IsTopicEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry associated with the topics."
INDEX { IMPLIED topic }
::= {isTopicTable 1}
-- Instrumentation : Config file
IsTopicEntry ::= SEQUENCE {
isTopic DisplayString
}
isTopic OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A textual description of a topic."
::= {isTopicEntry 1}
--
-- This group provides general access information and access information
-- organized by domain, day, most recent users, most frequent users.
--
isAccess OBJECT IDENTIFIER ::= { isObjects 2 }
Expires October 22, 1996 [Page 13]
Internet Draft Information Store MIB April 22, 1996
isNumberOfAccesses OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number accesses done at the Information
Store."
::= { isAccess 1 }
-- Instrumentation : Log file
isNumberOfBytesOut OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number bytes transfered by the Information
Store."
::= { isAccess 2 }
-- Instrumentation : Log file
isNumberOfBytesIn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number bytes received by the Information
Store."
::= { isAccess 3 }
-- Instrumentation : Direct access
isDomainTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsDomainEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The domain table keeps track of the number of
accesses done from a specific domain."
::= { isAccess 4 }
-- Instrumentation : Log file
isDomainEntry OBJECT-TYPE
SYNTAX IsDomainEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entry (conceptual row) of the domain table."
INDEX { IMPLIED domainName }
::= { isDomainTable 1 }
IsDomainEntry ::= SEQUENCE {
isDomainName DisplayString,
isDomainAccesses Counter32
}
Expires October 22, 1996 [Page 14]
Internet Draft Information Store MIB April 22, 1996
isDomainName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The domain of which the number of accesses
specific has to be monitored."
::= { isDomainEntry 1 }
-- Instrumentation : Log file
isDomainAccesses OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of accesses done from a certain domain."
::= { isDomainEntry 2 }
-- Instrumentation : Log file
isAccessOfLastNDaysTableSize OBJECT-TYPE
SYNTAX INTEGER (0..32)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The number of entries which is contained
in the accessOfLastNDaysTable."
::= { isAccess 5 }
-- Instrumentation : Agent internal
isAccessOfLastNDaysTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsAccessOfLastNDaysEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The access of last days table keeps track of the
number of accesses that have been done in the past.
Each entry is a specific day in the past. The day
which is specified is related to the current day.
This table should be a Top N table and should be
configured by the NMS."
::= { isAccess 6 }
isAccessOfLastNDaysEntry OBJECT-TYPE
SYNTAX IsAccessOfLastNDaysEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entry (conceptual row) of the accessOfLastNDaysTable."
INDEX { lastNDayIndex }
::= { accessOfLastNDaysTable 1 }
Expires October 22, 1996 [Page 15]
Internet Draft Information Store MIB April 22, 1996
IsAccessOfLastNDaysEntry ::= SEQUENCE {
isLastNDayIndex INTEGER,
isAccessOflastNDay Counter32
}
isLastNDayIndex OBJECT-TYPE
SYNTAX INTEGER (0..32)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index of the Last N Days Table"
::= { accessOfLastNDaysEntry 1 }
-- Instrumentation : Agent internal
isAccessOflastNDay OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of accesses done on the specified day
in the past."
::= { accessOfLastNDaysEntry 2 }
-- Instrumentation : logfile
isMostFrequentNUserTableSize OBJECT-TYPE
SYNTAX INTEGER (0..128)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The number of entries which is contained
in the MostFrequentNUserTable."
::= { isAccess 7 }
-- Instrumentation : Agent internal
isMostFrequentNUserTableRefresh OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Field with which a new `most frequent N user table'
will be made."
::= { isAccess 8 }
-- Instrumentation : Agent internal
isMostFrequentNUserTableDate OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The universal date and time for the last time the
isMostFrequentNUserTable was refreshed.."
::= { isAccess 9 }
-- Instrumentation : Agent internal
Expires October 22, 1996 [Page 16]
Internet Draft Information Store MIB April 22, 1996
isMostFrequentNUserTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsMostFrequentNUserEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The access of document table keeps track of the
number of accesses that have been done in the past.
Each entry is a separate user.
This is a Top N table with the N most recently accessed
documents."
::= { isAccess 10 }
isMostFrequentNUserEntry OBJECT-TYPE
SYNTAX IsMostFrequentNUserEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entry (conceptual row) of the document table."
INDEX { mfIndex }
::= { isMostFrequentNUserTable 1 }
IsMostFrequentNUserEntry ::= SEQUENCE {
isMfIndex INTEGER,
isMfUserName DisplayString,
isMfNumberOfAccesses Counter32
}
isMfIndex OBJECT-TYPE
SYNTAX INTEGER (0..128)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index indicates the position in the Top N table."
::= { isMostFrequentNUserEntry 1 }
-- Instrumentation : Agent internal
isMfUserName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of the user."
::= { isMostFrequentNUserEntry 2 }
-- Instrumentation : Log file
Expires October 22, 1996 [Page 17]
Internet Draft Information Store MIB April 22, 1996
isMfNumberOfAccesses OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of accesses made by the user on
this server."
::= { isMostFrequentNUserEntry 3 }
-- Instrumentation : Log file
isMostRecentNUserTableSize OBJECT-TYPE
SYNTAX INTEGER (0..128)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The number of entries which is contained
in the isMostRecentNUserTable."
::= { isAccess 11 }
-- Instrumentation : Agent internal
isMostRecentNUserTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsMostRecentNUserEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The access of document table keeps track of the
number of accesses that have been done in the past.
Each entry is a document.
This is a Top N table with the N most recently accessed
documents."
::= { isAccess 12 }
isMostRecentNUserEntry OBJECT-TYPE
SYNTAX IsMostRecentNUserEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entry (conceptual row) of the most recent users table."
INDEX { mrIndex }
::= { isMostRecentNUserTable 1 }
IsMostRecentNUserEntry ::= SEQUENCE {
isMrIndex INTEGER,
isMrUserName DisplayString,
isMrLastTime DateAndTime,
isMrLastDocument DisplayString
}
Expires October 22, 1996 [Page 18]
Internet Draft Information Store MIB April 22, 1996
isMrIndex OBJECT-TYPE
SYNTAX INTEGER (0..128)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index indicates the sequence of the recent users."
::= { isMostRecentNUserEntry 1 }
-- Instrumentation : Agent internal
isMrUserName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of the user."
::= { isMostRecentNUserEntry 2 }
-- Instrumentation : Log file
isMrLastTime OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The last time the user has accessed this server."
::= { isMostRecentNUserEntry 3 }
-- Instrumentation : Log file
isMrLastDocument OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The last operation or document which is accessed
by the user at this server."
::= { isMostRecentNUserEntry 4 }
-- Instrumentation : Log file
--
-- The section of the errors that occured in the Information Store.
--
isErrors OBJECT IDENTIFIER ::= { isObjects 3 }
Expires October 22, 1996 [Page 19]
Internet Draft Information Store MIB April 22, 1996
isErrorTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsErrorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The access of document table keeps track of the
number of accesses that have been done in the past.
Each entry is a document.
This is a Top N table with the N most recently accessed
documents."
::= { isErrors 12 }
isErrorEntry OBJECT-TYPE
SYNTAX IsErrorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entry (conceptual row) of the document table."
INDEX { errorIndex }
::= { isErrorTable 1 }
IsErrorEntry ::= SEQUENCE {
isErrorIndex INTEGER,
isErrorDescription DisplayString,
isErrorCount Counter32,
isErrorLastTime TimeStamp
}
isErrorIndex OBJECT-TYPE
SYNTAX INTEGER (0..128)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index indicating the error."
::= { isErrorEntry 1 }
isErrorDescription OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The textual description of the error."
::= { isErrorEntry 2 }
isErrorCount OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of errors that occured."
::= { isErrorEntry 3 }
Expires October 22, 1996 [Page 20]
Internet Draft Information Store MIB April 22, 1996
isErrorLastTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The time of the last error occured."
::= { isErrorEntry 4 }
--
-- This group contains information about documents which are accessed
-- on the Information Store Server. That are the documents accessed since
-- the start of the server. This are the URI with which a information
-- can be accessed.
-- For example a document is index.html:
-- If this is a document retrieved from the directory root of the
-- Information Store.
-- If this document is in a directory beneath the directory root it
-- should also mention this path in the isDocumentName.
-- <path>'/'<name of script>
--
-- For example a document script of the cgi-interface:
-- The script is mentioned in this table with the isDocumentName
-- `cgi/'<path>'/'<name of script>
--
isDocuments OBJECT IDENTIFIER ::= { isObjects 4 }
isDocumentTableSize OBJECT-TYPE
SYNTAX INTEGER (0..128)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The number of entries which are contained
in the isDocumentTable."
::= { isDocuments 1 }
isDocumentTableRefresh OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Field with which a new `document table' will be made."
::= { isDocuments 2 }
isDocumentTableDate OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The universal date and time for the last time the
isDocumentTable was refreshed."
::= { isDocuments 3 }
Expires October 22, 1996 [Page 21]
Internet Draft Information Store MIB April 22, 1996
isDocumentTable OBJECT-TYPE
SYNTAX SEQUENCE OF IsDocumentEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The access of document table keeps track of the
number of accesses that have been done in the past.
Each entry is a document."
::= { isDocuments 4 }
isDocumentEntry OBJECT-TYPE
SYNTAX IsDocumentEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Entry (conceptual row) of the document table."
INDEX { documentIndex }
::= { isDocumentTable 1 }
IsDocumentEntry ::= SEQUENCE {
isDocumentIndex INTEGER,
isDocumentName DisplayString,
isDocumentAccesses Counter32,
isDocumentAccessRight AccessRights,
isDocumentSize Integer32,
isDocumentErrors Counter32,
isDocumentUpdate DateAndTime,
isDocumentAccessesAtLastUpdate Counter32,
isDocumentLastAccess DateAndTime,
isDocumentType MediaType
}
isDocumentIndex OBJECT-TYPE
SYNTAX INTEGER (0..127)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The ranking of the document is a top N table."
::= { isDocumentEntry 1 }
-- Instrumentation : Log file
isDocumentName OBJECT-TYPE
SYNTAX DisplayString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of the document available at the Information
Store."
::= { isDocumentEntry 2 }
-- Instrumentation : Log file
Expires October 22, 1996 [Page 22]
Internet Draft Information Store MIB April 22, 1996
isDocumentAccesses OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of accesses of the document."
::= { isDocumentEntry 3 }
-- Instrumentation : Log file
isDocumentAccessRights OBJECT-TYPE
SYNTAX AccessRights
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The accessrights of the document. This field should
restrict the information retrieval of the clients."
::= { isDocumentEntry 4 }
-- Instrumentation : System
isDocumentSize OBJECT-TYPE
SYNTAX Integer32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The size of the document in bytes (octets)."
::= { isDocumentEntry 5 }
-- Instrumentation : System
isDocumentErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of errors that occured during accessing
this document."
::= { isDocumentEntry 6 }
-- Instrumentation : Log file
isDocumentUpdate OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Date and time when this file was last updated."
::= { isDocumentEntry 7 }
-- Instrumentation : System
Expires October 22, 1996 [Page 23]
Internet Draft Information Store MIB April 22, 1996
isDocumentAccessesAtLastUpdate OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of accesses of the document since
the document was updated for the last time."
::= { isDocumentEntry 8 }
-- Instrumentation : System
isDocumentLastAccess OBJECT-TYPE
SYNTAX DateAndTime
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The date and time the document was last accessed."
::= { isDocumentEntry 9 }
-- Instrumentation : Log file
isDocumentType OBJECT-TYPE
SYNTAX MediaType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of the document."
::= { isDocumentEntry 10 }
-- Instrumentation : -
--
-- Conformance and compliance definitions.
--
isGeneralGroup OBJECT-GROUP
OBJECTS { isName,
isOrganisation,
isContact,
isLastInitialisation,
isSupportedMediaTypes,
isTopic }
STATUS current
DESCRIPTION
"The isGeneralGroup defines the objects
which are common to all Information Store
applications"
::= { isGroups 1 }
Expires October 22, 1996 [Page 24]
Internet Draft Information Store MIB April 22, 1996
isApplDependancyGroup OBJECT-GROUP
OBJECTS{
isApplResourceIdentifier, isApplProcessName,
isApplVersion, isApplUptime,
isApplOperStatus, isApplLastChange,
isApplLastActivity, isApplFailedActivities }
STATUS current
DESCRIPTION
"The application dependency Group provides information
about additional processes (or helper processes) of
the information store."
::= { isGroups 2 }
isErrorGroup OBJECT-GROUP
OBJECTS { isErrorIndex, isErrorDescription,
isErrorCount, isErrorLastTime }
STATUS current
DESCRIPTION
"The isErrorGroup provides the information
about the errors occured with the
information store."
::= { isGroups 3 }
isAccessGroup OBJECT-GROUP
OBJECTS {
isNumberOfAccesses,
isNumberOfBytesOut,
isNumberOfBytesIn,
isDomainName, isDomainAccesses,
isAccessOfLastNDaysTableSize,
isLastNDayIndex, isAccessOflastNDay,
isMrUserName, isMrLastTime, isMrLastDocument,
isMostRecentNUserTableSize,
isMostFrequentNUserTableSize,
isMostFrequentNUserTableRefresh,
isMostFrequentNUserTableDate,
isMfUserName, isMfNumberOfAccesses }
STATUS current
DESCRIPTION
"The isAccessGroup provides the information
about the accesses performed on this
information store..
The group defines the total number of accesses
and the number of bytes belonging to the accesses.
The otherwise the accesses or ordered in tables
The ordination are:
by domain,
by day (LastNDays),
by most frequent users (TopN),
by most recent users (LastN)"
::= { isGroups 4 }
Expires October 22, 1996 [Page 25]
Internet Draft Information Store MIB April 22, 1996
isDocumentGroup OBJECT-GROUP
OBJECTS {
isDocumentTableSize,
isDocumentTableRefresh,
isDocumentTableDate,
isDocumentName,
isDocumentAccesses, isDocumentAccessRights,
isDocumentSize, isDocumentErrors, isDocumentUpdate,
isDocumentAccessesAtLastUpdate, isDocumentLastAccess,
isDocumentType }
STATUS current
DESCRIPTION
"The isDocumentGroup provides the information
about the accesses which can be made on the
information store."
::= { isGroups 5 }
isMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statements for http entities
which implement the HTTP MIB"
MODULE
MANDATORY-GROUPS {
isGeneralGroup,
isApplDependancyGroup,
isErrorGroup,
isAccessGroup,
isDocumentGroup }
::= { isCompliances 1 }
END
Expires October 22, 1996 [Page 26]
Internet Draft Information Store MIB April 22, 1996
6. Acknowledgments
This document has been produced by the University of Twente
(The Netherlands), together with ESYS Limited (The United Kingdom),
as part of a `proof of concept' study for the `Centre of Earth
Observation' (CEO) of the `Joint Research Centre' (JRC) of the
European Community. This document has benefited greatly to the
comments of:
Mark Gamble
<mgamble@esys1.esys.co.uk>
Rui Meneses
<rui.meneses@jrc.it>
Juergen Schoenwaelder
<schoenw@cs.utwente.nl>
Expires October 22, 1996 [Page 27]
Internet Draft Information Store MIB April 22, 1996
7. References
[1] SNMPv2 Working Group, 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.
[2] McCloghrie, K., and M. Rose, Editors, "Management Information Base
for Network Management of TCP/IP-based internets: MIB-II", STD 17,
RFC 1213, Hughes LAN Systems, Performance Systems International,
March 1991.
[3] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
S. Waldbusser, "Textual Conventions for version 2 of the Simple
Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
[4] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
S. Waldbusser, "Protocol Operations for version 2 of the Simple
Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
[5] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
S. Waldbusser, "Conformance Statements for version 2 of the Simple
Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
[6] Case, J., M. Fedor, M. Schoffstall, J. Davin, "Simple Network
Management Protocol", RFC 1157, SNMP Research, Performance Systems
International, MIT Laboratory for Computer Science, May 1990.
[7] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
S. Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901,
January 1996.
8. Security Considerations
Security issues are not discussed in this memo.
9. Authors' Addresses
Harrie Hazewinkel / Eric van Hengstum / Aiko Pras
University of Twente
Centre for Telematics and Information Technology (CTIT)
POBox 217
7500 AE Enschede, The Netherlands
Phone: +31-53-4893778
Email: hazewink@cs.utwente.nl
hengstum@cs.utwente.nl
pras@cs.utwente.nl
Expires October 22, 1996 [Page 28]
Internet Draft Information Store MIB April 22, 1996
Table of Contents
1 Abstract .................................................. 2
2 The SNMPv2 Network Management Framework ................... 3
2.1 Object Definitions ...................................... 3
3 Introduction .............................................. 4
4 Information Store MIB structure ........................... 4
4.1 General group ........................................... 4
4.2 Access group ............................................ 5
4.2 Error group ............................................. 6
4.2 Document group .......................................... 6
5 Information Store MIB definition .......................... 7
6 Acknowledgements .......................................... 27
7 References ................................................ 28
8 Security Considerations ................................... 28
9 Authors' Addresses ........................................ 28
Expires October 22, 1996 [Page 29]