home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_a_c / draft-ietf-applmib-wwwmib-00.txt < prev    next >
Text File  |  1996-11-26  |  92KB  |  2,615 lines
  1.  
  2. INTERNET DRAFT                 WWW MIB                December 1, 1996
  3.  
  4.             Definitions of Managed Objects for WWW Servers
  5.  
  6.  
  7.                    <draft-ietf-applmib-wwwmib-00.txt>
  8.  
  9.  
  10.  
  11.                           Carl W. Kalbfleisch
  12.                        OnRamp Technologies, Inc.
  13.                             cwk@onramp.net
  14.  
  15.  
  16.  
  17.                            Harrie Hazewinkel
  18.                             DESIRE / MUSIQ
  19.                    Joint Research Centre of the E.C.
  20.                        harrie.hazewinkel@jrc.it
  21.  
  22.  
  23.  
  24.                         Juergen Schoenwaelder
  25.                          University of Twente
  26.                         schoenw@cs.utwente.nl
  27.  
  28.  
  29.                           December 1, 1996
  30.  
  31.  
  32.  
  33.                          Status of this Memo
  34.  
  35.   This document is an Internet-Draft.  Internet-Drafts are working
  36.   documents of the Internet Engineering Task Force (IETF), its
  37.   areas, and its working groups.  Note that other groups may also
  38.   distribute working documents as Internet-Drafts.
  39.  
  40.   Internet-Drafts are draft documents valid for a maximum of six
  41.   months and may be updated, replaced, or obsoleted by other
  42.   documents at any time.  It is inappropriate to use Internet-
  43.   Drafts as reference material or to cite them other than as
  44.   ``work in progress.''
  45.  
  46.   To learn the current status of any Internet-Draft, please check
  47.   the ``1id-abstracts.txt'' listing contained in the Internet-
  48.   Drafts Shadow Directories on ftp.is.co.za (Africa),
  49.   nic.nordu.net (Europe), munnari.oz.au (Pacific Rim),
  50.   ds.internic.net (US East Coast), or ftp.isi.edu (US West Coast).
  51.  
  52.   Distribution of this document is unlimited. Please send comments
  53.   to the HTTP-MIB mailing list <http-mib@onramp.net>. Discussions of
  54.   the mailing list are archived at
  55.   <URL:http://http-mib.onramp.net/archive/> General discussions about
  56.   application MIBs should take place on the Application MIB Working
  57.  
  58. Expires June 1, 1997                                      [Page 1]
  59.  
  60. INTERNET DRAFT                 WWW MIB                December 1, 1996
  61.   Group, <applmib@emi-summit.com>, mailing list.
  62.  
  63. 1. Abstract
  64.  
  65.   This memo defines an experimental portion of the Management
  66.   Information Base (MIB) for use with network management
  67.   protocols in the Internet Community. In particular it
  68.   describes a set of managed objects for WWW servers. These
  69.   objects include extensions to Network Services Monitoring
  70.   MIB, extensions to sysApplMIB, error reporting and document
  71.   storage information. Some portions of this information are
  72.   not yet defined and will be added to this document in future
  73.   revisions.  These attributes are applicable to the HTTP
  74.   protocol of WWW but may also be applicable to other information
  75.   retrieval services like ftp, nntp, gopher and wais.
  76.  
  77. 2. The SNMPv2 Network Management Framework
  78.  
  79.   The SNMPv2 Network Management Framework consists of four major
  80.   components.  They are:
  81.  
  82.   o  STD 17, RFC 1213 [1] defines MIB-II, the core set of managed
  83.      objects for the Internet suite of protocols.
  84.  
  85.   o  RFC 1902 Structure of Management Information for Version 2 of
  86.      the Simple Network Management Protocol (SNMPv2)
  87.  
  88.   o  RFC 1903 Textual Conventions for Version 2 of the Simple
  89.      Network Management Protocol (SNMPv2)
  90.  
  91.   o  RFC 1904 Conformance Statements for Version 2 of the Simple
  92.      Network Management Protocol (SNMPv2)
  93.  
  94.   o  RFC 1905 Protocol Operations for Version 2 of the Simple
  95.      Network Management Protocol (SNMPv2)
  96.  
  97.   o  RFC 1906 Transport Mappings for Version 2 of the Simple
  98.      Network Management Protocol (SNMPv2)
  99.  
  100.   o  RFC 1907 Management Information Base for Version 2 of the
  101.      Simple Network Management Protocol (SNMPv2)
  102.  
  103.   o  RFC 1908 Coexistence between Version 1 and Version 2 of the
  104.      Internet-standard Network Management Framework
  105.  
  106.   The Framework permits new objects to be defined for the purpose of
  107.   experimentation and evaluation.
  108.  
  109. 2.1. Object Definitions
  110.  
  111.   Managed objects are accessed via a virtual information store,
  112.   termed the Management Information Base or MIB. Objects in the MIB
  113.   are defined using the subset of Abstract Syntax Notation One
  114.   (ASN.1) defined in the SMI [ref]. In particular, each object type is
  115.  
  116. Expires June 1, 1997                                      [Page 2]
  117.  
  118. INTERNET DRAFT                 WWW MIB                December 1, 1996
  119.   named by an OBJECT IDENTIFIER, an administratively assigned name.
  120.   The object type together with an object instance serves to
  121.   uniquely identify a specific instantiation of the object. For
  122.   human convenience, we often use a textual string, termed the
  123.   object descriptor, to refer to the object type.
  124.  
  125. 3. Notation
  126.  
  127.   This notation [## .. ##] delineates editorial text. This
  128.   information will either be removed in the final document or
  129.   replaced with real text at those points.
  130.  
  131. 4. A Note on Terminology
  132.  
  133.   This section defines the terminology used throughout this draft.
  134.  
  135.   The 'World Wide Web' (WWW) is the name of a world wide information
  136.   system which is based on the concept of documents that can be linked
  137.   together by embedding references to documents located at local or
  138.   remote locations. References to a document are made using Uniform
  139.   Resource Locators (URL) as defined in RFC 1738 [?].
  140.  
  141.   A 'WWW-site' is defined as a host in the Internet that embodies
  142.   the WWW.
  143.  
  144.   A 'document' is defined like a coherent piece of information/data.
  145.   No assumptions are made about the content or type.
  146.  
  147.   A 'Document Transport Protocol' (DTP) is defined as a generic name
  148.   for all protocols that allow to perform operations on 'documents'
  149.   stored on WWW-sites.
  150.  
  151.   A 'Uniform Resource Locator' (URL) is defined as formatted string
  152.   representation for a 'document' available via the Internet.
  153.   The 'URL' maps onto a certain 'DTP' and 'WWW-site' of where and how
  154.   to retrieve a 'document'.
  155.   For the syntax and semantics of the string representation is
  156.   referred to rfc1630 [?] and rfc1738 [?]
  157.  
  158.   A 'request' is defined as a protocol operation which is targeted to
  159.   a 'document' and invokes an action on the target document. The
  160.   'request type' specifies the action that should be performed and
  161.   a 'request' can have a document attached to it.
  162.  
  163.   A 'response' is defined as a protocol operation which is returned as
  164.   a result of a previous (and associated) request. The 'response
  165.   status' indicates if the requested action was successful or if
  166.   errors occurred. A 'response' can have a document attached to it.
  167.  
  168.   An 'application' is defined as one or more units of executable code
  169.   and other resources, installed on a single host system that a manager
  170.   may think of as a single object for management purposes.
  171.  
  172.   A 'networked application' is defined as an application type which
  173.  
  174. Expires June 1, 1997                                      [Page 3]
  175.  
  176. INTERNET DRAFT                 WWW MIB                December 1, 1996
  177.   is not neccesaryly installed an a single host, but makes use of an
  178.   underlying transport protocol in order to behave as a single object
  179.   in the eyes of an operator.
  180.  
  181.   A 'server' is defined as the networked application invoking the DTP
  182.   operations. A 'server' provides access facilty to 'documents' and/or
  183.   storage facilty of 'documents'. The 'document' resides on locally
  184.   accessible disks or in applications processing the DTP operations.
  185.  
  186.   A 'client' is defined as the networked application invoking the DTP
  187.   operations. A 'clients issues the 'requests' and interprets the
  188.   'responses'.
  189.  
  190.   A 'proxy' is defined as a networked application acting both as
  191.   server and client for the purpose of making request for other
  192.   clients. 'Requests' and 'responses' are passed by the 'proxy' with
  193.   possible mapping between different DTP's. The 'proxy doesn't
  194.   change the 'document' transferred.
  195.  
  196.   A 'caching proxy' is defined as a proxy with the capability of
  197.   locally storing 'responses' to associated 'requests' in order to
  198.   respond with the local stored 'response' to the associated 'request'.
  199.  
  200.   An 'entity' is defined as a 'server', a 'client', a 'proxy' or ' a
  201.   'caching proxy' which can be accessed by an unique transport address.
  202.  
  203. 5. Introduction
  204.  
  205.   The World Wide Web (WWW) is a network of information, accessible
  206.   via a simple easy to use interface. The information is often
  207.   presented in HyperText and/or multi-media. The information is
  208.   provided by servers which are located all around the world and
  209.   are linked to each other via hyperlinks.
  210.   The protocol these servers listen to is the Hypertext Transfer
  211.   Protocol performing the actual transfer of the information.
  212.   The usability of the web depends largely on the performance of
  213.   these servers. WWW servers are typically monitored through log
  214.   files. This becomes a difficult task when a single organization is
  215.   responsible for a number of servers. Since many organizations
  216.   currently use the Internet Standard SNMP to manage their network
  217.   devices, it is desirable to treat these WWW servers as additional
  218.   devices within this framework. This will allow a single Network
  219.   Management Station (NMS) to automate the management of a number of
  220.   WWW servers as well as the entire enterprise. Defining a standard for
  221.   this purpose allows a single management application to manage a
  222.   number of servers from a variety of vendors.  Additionally, a formal
  223.   definition of what has to be managed and how to manage it tends to
  224.   lead to integrated and improved performance and fault management.
  225.  
  226. 6. WWW Entities
  227.  
  228.   The focus of this MIB is the management of WWW entities. These
  229.   entities are servers, clients and proxies which communicate with
  230.   each other using the HyperText transfer Protocol (HTTP). This is a
  231.  
  232. Expires June 1, 1997                                      [Page 4]
  233.  
  234. INTERNET DRAFT                 WWW MIB                December 1, 1996
  235.   stateless protocol based on the Client/ Server paradigm. Therefore,
  236.   this MIB includes WWW Server, client and proxy role of the WWW
  237.   entity. The following section describe what is meant by server,
  238.   client and proxy entities.
  239.  
  240.   Due to the similarity of HTTP to other information retrieval
  241.   protocols, it is anticipated that this MIB may be directly useful to
  242.   the management of applications processing other types of protocols
  243.   such ftp, nntp, gopher and wais. An appendix is provided to describe
  244.   how such application of this MIB might be made to other protocols.
  245.  
  246. 6.1. WWW Server
  247.  
  248.   A WWW server is a proprietor of a general store of information. It
  249.   waits for a client to come with a request for information and then
  250.   returns the requested information to the client.
  251.  
  252.   The coverage of this MIB is suitable for WWW server although certain
  253.   variables are not relevant in case the MIB is used for WWW server
  254.   management. In that case the not relevant objects should return the
  255.   zero-value.
  256.  
  257. 6.2. WWW Client
  258.  
  259.   A WWW client, or also called a browser, is a application which can
  260.   request information from server and present the returned information
  261.   in the appropriate format. Whenever, the client application cannot
  262.   display the proper format of the retrieved information helper
  263.   applications assist the WWW client with presenting the information.
  264.  
  265.   The coverage of this MIB is primerly for WWW servers, but clients
  266.   can be managed by it as well. In case of managing the client certain
  267.   variables are not relevant which should than return the zero-value.
  268.  
  269.  
  270. 6.3. WWW Proxy
  271.  
  272.   Proxies are used to provide transformations of information passed
  273.   between systems/ applications. The proxies are inside the chain of
  274.   the client and the server handling the request for the operator.
  275.   That server is not necesarrily an WWW server, but can also be an
  276.   other type of application providing information requested. Such an
  277.   application can be, for instance, a database which can be examined
  278.   with SQL. In this particular case the proxy transfers the
  279.   HTTP-request into SQL request and performs the other way around on
  280.   the SQL respond by transferring it into an HTTP-request. Another
  281.   way of using the proxy is to create some extra fire-wall whereby
  282.   the proxy takes care of security issues. Although, this is not a
  283.   real proxy.
  284.  
  285.   To have useful management information about proxies the MIB
  286.   definition contains objects for outgoing and incoming of any
  287.   particular request or response. Derived information from these so
  288.   called low-level values are dependant on the use. For instance, if
  289.  
  290. Expires June 1, 1997                                      [Page 5]
  291.  
  292. INTERNET DRAFT                 WWW MIB                December 1, 1996
  293.   request are transformed into database requests you can have
  294.   information on successful transformations. Whenever the proxy is
  295.   used inside the fire-wall you can see how many attempts of
  296.   breaking the fire-wall were made. This last one can mean there is
  297.   someone trying to break a way into your network.
  298.  
  299. 6.4. WWW Cached Proxy
  300.  
  301.   A special kind of proxies are the cached proxies. They are not
  302.   always requesting information from the server lying behind. The
  303.   cache contains already information made by earlier requests. The
  304.   cached proxy uses that information to return the appropriate
  305.   information without asking the real information provider.
  306.  
  307.   The useful network management information is here to know how
  308.   many requests were already inside the cache of the proxy. This can
  309.   also be explained as the so called 'hits/miss'-ratio. Although that
  310.   this variable contained explicitly by this MIB and is inside the
  311.   MIB. This ratio can be calculated by the two objects incoming
  312.   requests and outgoing requests or even by the responses.
  313.  
  314. 7. HTTP Message
  315.  
  316.   The WWW server, client and proxy described above communicate with
  317.   each other using HTTP Messages. A HTTP message consist of request
  318.   from clients to servers and responses from servers to clients. The
  319.   message types use the generic format of RFC 822 [## ref TBD ##].
  320.  
  321.         generic-message = ( Request-Line | Status-Line)
  322.                           *message-header
  323.                           CRLF
  324.                           [ message-body ]
  325.  
  326.   The mapping of the message onto the byte counter need some special
  327.   attention. All bytes before the optional message-body are in this MIB
  328.   are counted as header bytes and the bytes of the message body are
  329.   named the data bytes.
  330.  
  331.   [## is this sufficiently clear to understand the *HeaderBytes and
  332.   *DataBytes attributes defined in the MIB ##]
  333.  
  334. 8. Relationship to other Standards Efforts
  335.  
  336.   WWW servers are seen as a specific type of generic application as
  337.   well as a specific type of networked application. For this reason,
  338.   their management can be viewed either in terms of the operational
  339.   model of the sysApplMIB or the service model of the NSM MIB. Since
  340.   organizations have members of their staff interested in one and/or
  341.   both of these models, this MIB is designed to address viewing the
  342.   WWW server from one and/or both models simultaneously.
  343.  
  344.   Additionally, users interested in both sets of data are interested in
  345.   the relationship between sysApplMIB and NSM. At the time of writing
  346.   this document, it is assumed that sysApplMIB will not address this
  347.  
  348. Expires June 1, 1997                                      [Page 6]
  349.  
  350. INTERNET DRAFT                 WWW MIB                December 1, 1996
  351.   relationship, so it is defined within this MIB. [## a conformance
  352.   statement which provides just the implementation of this relationship
  353.   is likely since other implementers may be interested in NSM, sysAppl
  354.   and their relationship without the attributes defined in this MIB.
  355.   For instance, any of the existing extentions to NSM could fit this
  356.   category. ##]
  357.  
  358.   These attributes are intended to address the requirements specified
  359.   in the document "Applicability of Standards Track MIBs to Management
  360.   of World Wide Web Servers" [ref].
  361.  
  362. 8.1. Relationship to NSM
  363.   The Network Services Monitoring MIB is defined as the base set of
  364.   attributes for managing network applications. This MIB extends that
  365.   set of attributes for items specific to WWW.
  366.  
  367. 8.2. Relationship to sysAppl and applMib
  368.  
  369.   The sysApplMIB defines attributes for management of applications
  370.   which can be realized without instrumenting an application. The
  371.   ApplMIB extends that framework to include additional attributes
  372.   which will require instrumentation. This MIB extends the framework
  373.   again with attributes specific to WWW.
  374.  
  375. 8.3. Document relation to sysApplInstall
  376.  
  377.   This MIB treats documents on the WWW server as packages installed
  378.   on the server. Any collection of documents can be defined as a
  379.   package. The wwwDocInstallPkg and wwwDocInstallElmt attributes
  380.   provide details of a document on the server.
  381.  
  382. 8.4. Usage example for NSM to sysApplMIB relationship
  383.  
  384.   The nsmToSysApplElmtRunTable is defined in the applMib to
  385.   relate NSM and sysApplMIB. The relationship between services
  386.   defined in the NSM and the applications and elements implementing
  387.   them in the sysAppl/applMIB framework depends on the implementation
  388.   of the software. The manager needs to be know about this so that a
  389.   management application can understand the ramification of such things
  390.   that effect instances in the various tables.
  391.  
  392.   WWW supporting "virtual hosts" on a single machine may implement to
  393.   NSM and sysAppl components quite differently. Two such
  394.   implementations are Apache and Netscape.
  395.  
  396.   Apache implements a set of processes each capable of servicing
  397.   requests for any of the virtual domains configured for the host.
  398.   In comparison, the Netscape server implements a set of processes
  399.   for each virtual domain.
  400.  
  401.   So if a machine were configured as the virtual domain servers for
  402.   www.a.com and www.b.com, then the following entries in NSM and
  403.   sysApplMIB would make sense:
  404.  
  405.  
  406. Expires June 1, 1997                                      [Page 7]
  407.  
  408. INTERNET DRAFT                 WWW MIB                December 1, 1996
  409.   Apache
  410.  
  411.   applTable
  412.       1) www.a.com
  413.       2) www.b.com
  414.  
  415.   sysApplRunTable
  416.       1) httpd
  417.  
  418.   sysApplElmtRunTable
  419.       1.1-1.N (where N is max simultaneous requests)
  420.  
  421.   Netscape
  422.  
  423.   applTable
  424.       1) www.a.com
  425.       2) www.b.com
  426.  
  427.   sysApplRunTable
  428.       1) httpd
  429.       2) httpd
  430.  
  431.   sysApplElmtRunTable
  432.       1.1 - 1.N ( N is max simultaneous for www.a.com)
  433.       2.1 - 2.M ( M is max simultaneous for www.a.com)
  434.  
  435.   With the definition of the nsmToSysApplElmtRunTable, the
  436.   relationships between the applTable and sysApplRunElmtTable
  437.   can be defined.  If N and M are both fixed to 2, then the
  438.   Apache and Netscape examples above would have the following
  439.   entries in the nsmToSysApplElmtRunTable:
  440.  
  441.   NOTE:  Entries in the following tables are of the form:
  442.  
  443.         index) applIndex <-> sysApplRunIndex.sysAppRunElmtIndex
  444.  
  445.   Apache
  446.         nsmToSysApplElmtRunTable
  447.                 1) 1 <-> 1.1
  448.                 2) 1 <-> 1.2
  449.                 3) 2 <-> 1.1
  450.                 4) 2 <-> 1.2
  451.  
  452.   Netscape
  453.                 1) 1 <-> 1.1
  454.                 2) 1 <-> 1.2
  455.                 3) 2 <-> 2.1
  456.                 4) 2 <-> 2.2
  457.  
  458.   The management application would read this table.  It would determine
  459.   if non-unique sysApplRunIndex.sysAppRunElmtIndex occur for different
  460.   values of applIndex and if so, know that control of those entries
  461.   would also effect the other entries.
  462.  
  463.  
  464. Expires June 1, 1997                                      [Page 8]
  465.  
  466. INTERNET DRAFT                 WWW MIB                December 1, 1996
  467. 9. Structure of the MIB
  468.  
  469.   This document defines a MIB for management of WWW servers.  The
  470.   MIB has the following portions:
  471.  
  472.   -Extensions to NSM [ref]
  473.   -Extensions to sysAppl [ref] framework
  474.   -error reporting
  475.   -document storage and statistics
  476.   -relationships to other MIBs
  477.  
  478. 9.1. The systems group
  479.  
  480.   The System group consists of a table describing all the entities
  481.   operated by this host. The table contains not only basic network
  482.   management information for (potentially) multiple entities running
  483.   on a single host, but also information for all entities within
  484.   virtual domains of the host. The columnar objects in the table
  485.   can be divided into two main groups:
  486.  
  487.   1. global administrative information of the entity, such as entity
  488.      contact person, and
  489.   2. network information, such as the transport address to which the
  490.      entity listens.
  491.  
  492.   [## see appendix todo list for discussion of the indexing of this
  493.   table ##]
  494.  
  495. 9.2. The Statistics group
  496.  
  497.   The statistics group provides network management information about
  498.   the traffic received or transmitted by an entity. This group contains
  499.   all network traffic related counters and consists of three tables,
  500.   which are the summary table, the request table and the response
  501.   table.
  502.  
  503. 9.2.1. SummaryTable
  504.  
  505.   The SummaryTable, containing a set of network traffic related
  506.   counters. The table provides a summarization of the network
  507.   traffic which is also found in the request and response table as
  508.   well as counters of discarded and unknown incoming traffic. It is
  509.   well recognized that certain variables are redundant with respect
  510.   to the request and response tables, but they are added to provide
  511.   an operator a quick network overview and reduce SNMP network
  512.   traffic.
  513.  
  514. 9.2.2. RequestTable
  515.  
  516.   The RequestTable contains the set of detailed information of
  517.   incoming and outgoing requests. Here every particular request type
  518.   can be counted seperately.
  519.  
  520. 9.2.3. ResponseTable
  521.  
  522. Expires June 1, 1997                                      [Page 9]
  523.  
  524. INTERNET DRAFT                 WWW MIB                December 1, 1996
  525.  
  526.   The ResponseTable contains the set of detailed information of
  527.   incoming and outgoing requests. Here every particular response type
  528.   can be counted seperately.
  529.  
  530. 9.3. The Document group
  531.  
  532.   The document group contains the network management information about
  533.   the accessed data. The group consists of the following tables.
  534.  
  535. 9.3.1. wwwDocNameTable
  536.  
  537.   The wwwDocNameTbale provides a means for fast indexing to an entry
  538.   into the document table given the name of the document.
  539.  
  540. 9.3.2. wwwDocTable
  541.  
  542.   The wwwDocTable defines the attributes maintained about a given
  543.   document. The statistics are defined based on the view of the
  544.   document from the service. The wwwDocInstallPkg and
  545.   wwwDocInstallElmt are provided to map to a file on the servers disk
  546.   and provide information via the sysAppl package framework on the
  547.  specifics of the file.
  548.  
  549. 9.3.3. wwwDocFilterTable
  550.   The wwwDocFilterTable is provided so that the manager can configure
  551.   which documents are stored into the other two tables. The filtering
  552.   is based on regular expressions [## need to define reference ##].
  553.   This allows the manage to customize the statistics that are gathered
  554.   to the most relevant documents that he is interested in.
  555.  
  556. 9.4. The Error group
  557.  
  558.   [## TBD ##]
  559.  
  560. 9.5. The Application group
  561.  
  562.   The application group defines those attributes which extend the
  563.   sysAppl/applMIB framework for WWW. For each table in the sysApplMIB,
  564.   a table is defined utilizing the defined indexing scheme to extend
  565.   the table for WWW specific attributes.
  566.  
  567.   [## additional sections can be added here when we define attributes
  568.   within the skeleton tables ##]
  569.  
  570. 9.6. The Relation group
  571.  
  572.   This group of objects defines how this MIB relates to other MIBs.
  573.  
  574. 10. Definitions
  575.  
  576.  
  577. WWW-MIB DEFINITIONS ::= BEGIN
  578.  
  579.  
  580. Expires June 1, 1997                                      [Page 10]
  581.  
  582. INTERNET DRAFT                 WWW MIB                December 1, 1996
  583. IMPORTS
  584.     applIndex                           FROM APPLICATION-MIB
  585.     sysApplInstallPkgIndex,
  586.     sysApplInstallElmtIndex,
  587.     sysApplRunIndex,
  588.     sysApplPastRunIndex, sysApplElmtRunIndex,sysApplElmtPastRunIndex,
  589.     sysApplElmtRunInvocID,
  590.     sysApplElmtPastRunInvocID           FROM SYSAPPL-MIB
  591.     ZeroBasedCounter32, TimeFilter      FROM RMON2-MIB
  592.     mib-2                               FROM RFC1213-MIB
  593.     MODULE-IDENTITY, OBJECT-TYPE,
  594.     Counter32, Integer32                FROM SNMPv2-SMI
  595.     TEXTUAL-CONVENTION, DisplayString,
  596.     TimeStamp, TAddress, DateAndTime,
  597.     RowStatus                           FROM SNMPv2-TC
  598.     MODULE-COMPLIANCE, OBJECT-GROUP     FROM SNMPv2-CONF;
  599.  
  600. wwwMIB MODULE-IDENTITY
  601.     LAST-UPDATED "9611190000Z"
  602.     ORGANIZATION "Application MIB Working Group"
  603.     CONTACT-INFO
  604.             "        Carl W. Kalbfleisch
  605.  
  606.              Postal: On-Ramp Technologies
  607.                      1950 Stemmons Freeway
  608.                      Suite 2026 - INFOMART
  609.                      Dallas, TX 75207
  610.                      US
  611.  
  612.                 Tel: +1 214 672-RAMP
  613.                 Fax: +1 214 672-7275
  614.  
  615.              E-mail: cwk@onramp.net"
  616.  
  617.     DESCRIPTION
  618.             "The MIB module for WWW enities. The MIB is named www-mib
  619.              although it should be applicable to include a wide family
  620.              of 'Networked Information Retrieval' protocols such as
  621.              http, nntp, ftp, gopher and wais."
  622.  
  623.     REVISION "9611190000Z"
  624.     DESCRIPTION
  625.             "Add skelton tables for extending sysApplMib framework
  626.              within the wwwAppl branch."
  627.  
  628.     REVISION "9609240000Z"
  629.     DESCRIPTION
  630.             "Update a number of descriptions to make MIB less www
  631.              specific and more general. Remove wwwEntityObjectID.
  632.              Move wwwDocNamePkg and wwwDocNameElmt to wwwDocInstallElmt
  633.              and wwwDocInstallPkg in wwwDocTable."
  634.  
  635.     REVISION "9609230000Z"
  636.     DESCRIPTION
  637.  
  638. Expires June 1, 1997                                      [Page 11]
  639.  
  640. INTERNET DRAFT                 WWW MIB                December 1, 1996
  641.             "Update a number of descriptions to make MIB less www
  642.              specific and more general. Changed names of Header/Data
  643.              byte attributes to Control/Content byte attributes."
  644.  
  645.     REVISION "9608160000Z"
  646.     DESCRIPTION
  647.             "Initial Internet Draft Release. This is based on two
  648.              previous revisions, neither of which were internet drafts.
  649.              See http://http-mib.onramp.net/ for archives, mailing
  650.              list, etc."
  651.  
  652.     ::= { mib-2 8080 }
  653.  
  654. --
  655. --  Object Identifiers for the www-MIB
  656. --
  657. wwwMIBObjects     OBJECT IDENTIFIER ::= { wwwMIB 1 }
  658. wwwMIBConformance OBJECT IDENTIFIER ::= { wwwMIB 2 }
  659. wwwMIBCompliances OBJECT IDENTIFIER ::= { wwwMIBConformance 1 }
  660. wwwMIBGroups      OBJECT IDENTIFIER ::= { wwwMIBConformance 2 }
  661.  
  662. --
  663. -- Textual Conventions
  664. --
  665. WwwRequestType ::= TEXTUAL-CONVENTION
  666.     STATUS       current
  667.     DESCRIPTION
  668.             "The WwwRequestType describes the types of requests.
  669.              The value of this type is exactly the same textual
  670.              identification of request types used in the information
  671.              transport protocol.
  672.  
  673.              For the proper values is refered to the specific protocol
  674.              specification."
  675.     SYNTAX       DisplayString (SIZE (1..40))
  676.  
  677.  
  678. WwwResponseType ::= TEXTUAL-CONVENTION
  679.     STATUS       current
  680.     DESCRIPTION
  681.             "The WwwResponseType defines the different response values
  682.              used by information transport protocols.
  683.              The value of this type are the 3-digit codes used in the
  684.              information transport protocol.
  685.  
  686.              For the proper values is refered to the specific protocol
  687.              specification."
  688.     SYNTAX       INTEGER (100..999)
  689.  
  690. --
  691. -- The following textual conventions are used for document
  692. -- storage.
  693. --
  694. WwwDocType::= TEXTUAL-CONVENTION
  695.  
  696. Expires June 1, 1997                                      [Page 12]
  697.  
  698. INTERNET DRAFT                 WWW MIB                December 1, 1996
  699.     STATUS       current
  700.     DESCRIPTION
  701.             "This data type is used to describe the document type.
  702.              It differentiates between 'static' and 'dynamic'
  703.              documents. A document is said to be 'static' if subsequent
  704.              accesses of the same document cause the same data to
  705.              be sent to the requestor. The document is not changed
  706.              during the processing of the request by the server and
  707.              transport towards the client. A document is said to be
  708.              'dynamic' if subsequent accesses of the file may produce
  709.              various response data depending on various input
  710.              parameters or run-time conditions."
  711.     SYNTAX INTEGER
  712.         {
  713.                 wwwDocStatic (1),
  714.                 wwwDocDynamic (2)
  715.         }
  716.  
  717. WwwDocName ::= TEXTUAL-CONVENTION
  718.     STATUS       current
  719.     DESCRIPTION
  720.             "The server relative name of a document. If the URL were
  721.              http://www.x.org/standards/search/search.cgi?string=test
  722.              then the value of this textual convention would resolve
  723.              to '/standards/search/search.cgi'."
  724.     SYNTAX DisplayString
  725.  
  726. WwwDocIndex ::= TEXTUAL-CONVENTION
  727.     STATUS       current
  728.     DESCRIPTION
  729.             "This data type is used to index documents. Index values
  730.              are monotonically increasing from 1. Index values are
  731.              not reused unless the value wraps. This means that if a
  732.              documents entry in the table is deleted, then re-added in
  733.              the document table because it is accessed again, then the
  734.              document will have a new index value."
  735.     SYNTAX INTEGER (1..2147483647)
  736.  
  737. --
  738. -- The www System Group
  739. --
  740. -- The www System group contains information about the www protocol
  741. -- entities.
  742. --
  743. wwwSystem OBJECT IDENTIFIER ::= { wwwMIBObjects 1 }
  744.  
  745. wwwEntityTable OBJECT-TYPE
  746.     SYNTAX      SEQUENCE OF WwwEntityEntry
  747.     MAX-ACCESS  not-accessible
  748.     STATUS      current
  749.     DESCRIPTION
  750.             "The table of the entities present on the system."
  751.     ::= { wwwSystem 1 }
  752.  
  753.  
  754. Expires June 1, 1997                                      [Page 13]
  755.  
  756. INTERNET DRAFT                 WWW MIB                December 1, 1996
  757. wwwEntityEntry OBJECT-TYPE
  758.     SYNTAX      WwwEntityEntry
  759.     MAX-ACCESS  not-accessible
  760.     STATUS      current
  761.     DESCRIPTION
  762.             "Details of a particular entity which can be a
  763.              Server, a Client, a Proxy or a Caching-Proxy."
  764.     INDEX   { applIndex }
  765.     ::= { wwwEntityTable 1 }
  766.  
  767. WwwEntityEntry ::= SEQUENCE {
  768.         wwwEntityDescription            DisplayString,
  769.         wwwEntityContact                DisplayString,
  770.         wwwEntityProtocol               OBJECT IDENTIFIER,
  771.         wwwEntityProtocolVersion        DisplayString,
  772.         wwwEntityName                   DisplayString,
  773.         wwwEntityAddress                TAddress,
  774.         wwwEntityType                   INTEGER
  775.     }
  776.  
  777.  
  778. wwwEntityDescription OBJECT-TYPE
  779.     SYNTAX      DisplayString
  780.     MAX-ACCESS  read-only
  781.     STATUS      current
  782.     DESCRIPTION
  783.             "Textual description of the entity.  This shall include
  784.              at least the vendor and version number of the application.
  785.              In a minimal case, this might be the Product Token for
  786.              the application."
  787.     ::= { wwwEntityEntry 1 }
  788.  
  789. wwwEntityContact OBJECT-TYPE
  790.     SYNTAX      DisplayString
  791.     MAX-ACCESS  read-only
  792.     STATUS      current
  793.     DESCRIPTION
  794.             "The textual identification of the contact person
  795.              for this entity, together with information on how
  796.              to contact this person.  For instance, this might
  797.              be 'webmaster@domain.name'."
  798.     ::= { wwwEntityEntry 2 }
  799.  
  800. wwwEntityProtocol OBJECT-TYPE
  801.     SYNTAX      OBJECT IDENTIFIER
  802.     MAX-ACCESS  read-only
  803.     STATUS      current
  804.     DESCRIPTION
  805.             "An identification of the primary protocol in use by this
  806.              entity. For Internet applications, the IANA maintains
  807.              a registry of the OIDs which correspond to well-known
  808.              applications.  If the application protocol is not listed
  809.              in the registry, an OID value of the form {applTCPProtoID
  810.              port} or {applUDProtoID port} are used for TCP-based and
  811.  
  812. Expires June 1, 1997                                      [Page 14]
  813.  
  814. INTERNET DRAFT                 WWW MIB                December 1, 1996
  815.              UDP-based protocols, respectively. In either case 'port'
  816.              corresponds to the primary port number being used by the
  817.              protocol."
  818.     ::= { wwwEntityEntry 3 }
  819.  
  820. wwwEntityProtocolVersion OBJECT-TYPE
  821.     SYNTAX      DisplayString
  822.     MAX-ACCESS  read-only
  823.     STATUS      current
  824.     DESCRIPTION
  825.             "Textual description of the version of the information
  826.              transport protocol implemented.
  827.              For HTTP version 1.1, the value shall be the 'HTTP/1.1'."
  828.     ::= { wwwEntityEntry 4 }
  829.  
  830. wwwEntityName OBJECT-TYPE
  831.     SYNTAX      DisplayString
  832.     MAX-ACCESS  read-only
  833.     STATUS      current
  834.     DESCRIPTION
  835.             "The fully qualified domain name by which this entity is
  836.              known.  This may be different than applName since that
  837.              value is only a textual name for the application."
  838.     ::= { wwwEntityEntry 5 }
  839.  
  840. wwwEntityAddress OBJECT-TYPE
  841.     SYNTAX      TAddress
  842.     MAX-ACCESS  read-only
  843.     STATUS      current
  844.     DESCRIPTION
  845.             "The Transport Address at which the entity listens for
  846.              Requests or Responses."
  847.     ::= { wwwEntityEntry 6 }
  848.  
  849. wwwEntityType OBJECT-TYPE
  850.     SYNTAX      INTEGER {
  851.                     server(1),
  852.                     client(2),
  853.                     proxy(3),
  854.                     cachingProxy(4)
  855.                 }
  856.     MAX-ACCESS  read-only
  857.     STATUS      current
  858.     DESCRIPTION
  859.             "Identification of the role of the entity."
  860.     ::= { wwwEntityEntry 7 }
  861.  
  862. -- The www Statistics Group
  863. --
  864. -- The www Statistics group contains information concerning the
  865. -- utilisation of the www protocol entity.
  866.  
  867. wwwStatistics OBJECT IDENTIFIER ::= { wwwMIBObjects 2 }
  868.  
  869.  
  870. Expires June 1, 1997                                      [Page 15]
  871.  
  872. INTERNET DRAFT                 WWW MIB                December 1, 1996
  873. --
  874. -- wwwSummaryTable
  875. --
  876. --
  877. wwwSummaryTable OBJECT-TYPE
  878.     SYNTAX SEQUENCE OF WwwSummaryEntry
  879.     MAX-ACCESS not-accessible
  880.     STATUS current
  881.     DESCRIPTION
  882.             "The table providing overview statistics for the
  883.              entities on this system."
  884.     ::= { wwwStatistics 1 }
  885.  
  886. wwwSummaryEntry        OBJECT-TYPE
  887.     SYNTAX      WwwSummaryEntry
  888.     MAX-ACCESS  not-accessible
  889.     STATUS      current
  890.     DESCRIPTION
  891.             "Overview statistics for an individual entity."
  892.     INDEX        { applIndex }
  893.     ::= { wwwSummaryTable 1 }
  894.  
  895.  
  896. WwwSummaryEntry ::= SEQUENCE {
  897.         wwwSummaryInRequests            Counter32,
  898.         wwwSummaryOutRequests           Counter32,
  899.         wwwSummaryRequestErrors         Counter32,
  900.         wwwSummaryRequestDiscards       Counter32,
  901.         wwwSummaryInResponses           Counter32,
  902.         wwwSummaryOutResponses          Counter32,
  903.         wwwSummaryResponseDiscards      Counter32,
  904.         wwwSummaryInUnknowns            Counter32,
  905.         wwwSummaryInControlBytes        Counter32,
  906.         wwwSummaryInContentBytes        Counter32,
  907.         wwwSummaryOutControlBytes       Counter32,
  908.         wwwSummaryOutContentBytes       Counter32
  909.     }
  910.  
  911. wwwSummaryInRequests OBJECT-TYPE
  912.     SYNTAX      Counter32
  913.     MAX-ACCESS  read-only
  914.     STATUS      current
  915.     DESCRIPTION
  916.             "The number of requests received by this entity."
  917.     ::= { wwwSummaryEntry 1 }
  918.  
  919. wwwSummaryOutRequests OBJECT-TYPE
  920.     SYNTAX      Counter32
  921.     MAX-ACCESS  read-only
  922.     STATUS      current
  923.     DESCRIPTION
  924.             "The number of requests generated by this entity."
  925.     ::= { wwwSummaryEntry 2 }
  926.  
  927.  
  928. Expires June 1, 1997                                      [Page 16]
  929.  
  930. INTERNET DRAFT                 WWW MIB                December 1, 1996
  931. wwwSummaryRequestErrors OBJECT-TYPE
  932.     SYNTAX      Counter32
  933.     MAX-ACCESS  read-only
  934.     STATUS      current
  935.     DESCRIPTION
  936.             "The number of requests containing errors and detected
  937.              by this entity"
  938.     ::= { wwwSummaryEntry 3 }
  939.  
  940. wwwSummaryRequestDiscards OBJECT-TYPE
  941.     SYNTAX      Counter32
  942.     MAX-ACCESS  read-only
  943.     STATUS      current
  944.     DESCRIPTION
  945.             "The number of requests discarded by this entity."
  946.     ::= { wwwSummaryEntry 4 }
  947.  
  948. wwwSummaryInResponses OBJECT-TYPE
  949.     SYNTAX      Counter32
  950.     MAX-ACCESS  read-only
  951.     STATUS      current
  952.     DESCRIPTION
  953.             "The number of responses received by this entity."
  954.     ::= { wwwSummaryEntry 5 }
  955.  
  956. wwwSummaryOutResponses OBJECT-TYPE
  957.     SYNTAX      Counter32
  958.     MAX-ACCESS  read-only
  959.     STATUS      current
  960.     DESCRIPTION
  961.             "The number of responses generated by this entity."
  962.     ::= { wwwSummaryEntry 6 }
  963.  
  964. wwwSummaryResponseDiscards OBJECT-TYPE
  965.     SYNTAX      Counter32
  966.     MAX-ACCESS  read-only
  967.     STATUS      current
  968.     DESCRIPTION
  969.             "The number of responses discarded by this entity."
  970.     ::= { wwwSummaryEntry 7 }
  971.  
  972. wwwSummaryInUnknowns OBJECT-TYPE
  973.     SYNTAX      Counter32
  974.     MAX-ACCESS  read-only
  975.     STATUS      current
  976.     DESCRIPTION
  977.             "The number of unknown messages detected by this entity."
  978.     ::= { wwwSummaryEntry 8 }
  979.  
  980. wwwSummaryInControlBytes OBJECT-TYPE
  981.     SYNTAX      Counter32
  982.     MAX-ACCESS  read-only
  983.     STATUS      current
  984.     DESCRIPTION
  985.  
  986. Expires June 1, 1997                                      [Page 17]
  987.  
  988. INTERNET DRAFT                 WWW MIB                December 1, 1996
  989.             "The number of protocol control bytes received by this
  990.              entity."
  991.     ::= { wwwSummaryEntry 9 }
  992.  
  993. wwwSummaryInContentBytes OBJECT-TYPE
  994.     SYNTAX      Counter32
  995.     MAX-ACCESS  read-only
  996.     STATUS      current
  997.     DESCRIPTION
  998.             "The number of protocol content bytes received by this
  999.              entity."
  1000.     ::= { wwwSummaryEntry 10 }
  1001.  
  1002. wwwSummaryOutControlBytes OBJECT-TYPE
  1003.     SYNTAX      Counter32
  1004.     MAX-ACCESS  read-only
  1005.     STATUS      current
  1006.     DESCRIPTION
  1007.             "The number of protocol control bytes generated by this
  1008.              entity."
  1009.     ::= { wwwSummaryEntry 11 }
  1010.  
  1011. wwwSummaryOutContentBytes OBJECT-TYPE
  1012.     SYNTAX      Counter32
  1013.     MAX-ACCESS  read-only
  1014.     STATUS      current
  1015.     DESCRIPTION
  1016.             "The number of protocol content bytes generated by this
  1017.              entity."
  1018.     ::= { wwwSummaryEntry 12 }
  1019.  
  1020. --
  1021. -- wwwRequestTable
  1022. --
  1023. --
  1024. --
  1025. --
  1026. wwwRequestTable        OBJECT-TYPE
  1027.     SYNTAX        SEQUENCE OF WwwRequestEntry
  1028.     MAX-ACCESS        not-accessible
  1029.     STATUS        current
  1030.     DESCRIPTION
  1031.             "The table providing detailed request statistics for the
  1032.              entities on this system."
  1033.     ::= { wwwStatistics 2 }
  1034.  
  1035. wwwRequestEntry        OBJECT-TYPE
  1036.     SYNTAX      WwwRequestEntry
  1037.     MAX-ACCESS  not-accessible
  1038.     STATUS      current
  1039.     DESCRIPTION
  1040.             "Request statistics for an individual entity."
  1041.     INDEX        { applIndex, wwwRequestIndex }
  1042.     ::= { wwwRequestTable 1 }
  1043.  
  1044. Expires June 1, 1997                                      [Page 18]
  1045.  
  1046. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1047.  
  1048. WwwRequestEntry ::= SEQUENCE {
  1049.         wwwRequestIndex                 WwwRequestType,
  1050.         wwwRequestInCount               Counter32,
  1051.         wwwRequestInControlBytes        Counter32,
  1052.         wwwRequestInContentBytes        Counter32,
  1053.         wwwRequestInLastTime            TimeStamp,
  1054.         wwwRequestOutCount              Counter32,
  1055.         wwwRequestOutControlBytes       Counter32,
  1056.         wwwRequestOutContentBytes       Counter32,
  1057.         wwwRequestOutLastTime           TimeStamp
  1058.     }
  1059.  
  1060. wwwRequestIndex OBJECT-TYPE
  1061.     SYNTAX      WwwRequestType
  1062.     MAX-ACCESS  not-accessible
  1063.     STATUS      current
  1064.     DESCRIPTION
  1065.             "The particular request type the statistics apply to."
  1066.     ::= { wwwRequestEntry 1 }
  1067.  
  1068. wwwRequestInCount OBJECT-TYPE
  1069.     SYNTAX      Counter32
  1070.     MAX-ACCESS  read-only
  1071.     STATUS      current
  1072.     DESCRIPTION
  1073.             "The number of requests of this type received by
  1074.              this entity."
  1075.     ::= { wwwRequestEntry 2 }
  1076.  
  1077. wwwRequestInControlBytes OBJECT-TYPE
  1078.     SYNTAX      Counter32
  1079.     MAX-ACCESS  read-only
  1080.     STATUS      current
  1081.     DESCRIPTION
  1082.             "The number of protocol control bytes of this type
  1083.              received by this entity."
  1084.     ::= { wwwRequestEntry 3 }
  1085.  
  1086. wwwRequestInContentBytes OBJECT-TYPE
  1087.     SYNTAX      Counter32
  1088.     MAX-ACCESS  read-only
  1089.     STATUS      current
  1090.     DESCRIPTION
  1091.             "The number of protocol content data bytes received
  1092.              with this type by this entity."
  1093.     ::= { wwwRequestEntry 4 }
  1094.  
  1095. wwwRequestInLastTime OBJECT-TYPE
  1096.     SYNTAX      TimeStamp
  1097.     MAX-ACCESS  read-only
  1098.     STATUS      current
  1099.     DESCRIPTION
  1100.             "The value of sysUpTime when the last byte of the last
  1101.  
  1102. Expires June 1, 1997                                      [Page 19]
  1103.  
  1104. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1105.              complete request of this type was received by this
  1106.       entity."
  1107.     ::= { wwwRequestEntry 5 }
  1108.  
  1109. wwwRequestOutCount OBJECT-TYPE
  1110.     SYNTAX      Counter32
  1111.     MAX-ACCESS  read-only
  1112.     STATUS      current
  1113.     DESCRIPTION
  1114.             "The number of requests of this type generated by this
  1115.              entity."
  1116.     ::= { wwwRequestEntry 6 }
  1117.  
  1118. wwwRequestOutControlBytes OBJECT-TYPE
  1119.     SYNTAX      Counter32
  1120.     MAX-ACCESS  read-only
  1121.     STATUS      current
  1122.     DESCRIPTION
  1123.             "The number of protocol control bytes of this type
  1124.              generated by this entity."
  1125.     ::= { wwwRequestEntry 7 }
  1126.  
  1127. wwwRequestOutContentBytes OBJECT-TYPE
  1128.     SYNTAX      Counter32
  1129.     MAX-ACCESS  read-only
  1130.     STATUS      current
  1131.     DESCRIPTION
  1132.             "The number of protocol content bytes generated by
  1133.       this type of request by this entity."
  1134.     ::= { wwwRequestEntry 8 }
  1135.  
  1136. wwwRequestOutLastTime OBJECT-TYPE
  1137.     SYNTAX      TimeStamp
  1138.     MAX-ACCESS  read-only
  1139.     STATUS      current
  1140.     DESCRIPTION
  1141.             "The value of sysUpTime when the first byte of the
  1142.       last request of this type was send by this entity."
  1143.     ::= { wwwRequestEntry 9 }
  1144.  
  1145. --
  1146. -- wwwResponseTable
  1147. --
  1148. --
  1149. --
  1150. --
  1151. wwwResponseTable OBJECT-TYPE
  1152.     SYNTAX        SEQUENCE OF WwwResponseEntry
  1153.     MAX-ACCESS    not-accessible
  1154.     STATUS        current
  1155.     DESCRIPTION
  1156.             "The table providing detailed response statistics for the
  1157.              entities on this system."
  1158.     ::= { wwwStatistics 3 }
  1159.  
  1160. Expires June 1, 1997                                      [Page 20]
  1161.  
  1162. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1163.  
  1164. wwwResponseEntry        OBJECT-TYPE
  1165.     SYNTAX      WwwResponseEntry
  1166.     MAX-ACCESS  not-accessible
  1167.     STATUS      current
  1168.     DESCRIPTION
  1169.             "Response statistics for an individual entity."
  1170.     INDEX        { applIndex, wwwResponseIndex }
  1171.     ::= { wwwResponseTable 1 }
  1172.  
  1173. WwwResponseEntry ::= SEQUENCE {
  1174.         wwwResponseIndex                WwwResponseType,
  1175.         wwwResponseInCount              Counter32,
  1176.         wwwResponseInControlBytes       Counter32,
  1177.         wwwResponseInContentBytes       Counter32,
  1178.         wwwResponseInLastTime           TimeStamp,
  1179.         wwwResponseOutCount             Counter32,
  1180.         wwwResponseOutControlBytes      Counter32,
  1181.         wwwResponseOutContentBytes      Counter32,
  1182.         wwwResponseOutLastTime          TimeStamp
  1183.     }
  1184.  
  1185. wwwResponseIndex OBJECT-TYPE
  1186.     SYNTAX      WwwResponseType
  1187.     MAX-ACCESS  not-accessible
  1188.     STATUS      current
  1189.     DESCRIPTION
  1190.             "The particular response type the statistics apply to."
  1191.     ::= { wwwResponseEntry 1 }
  1192.  
  1193. wwwResponseInCount OBJECT-TYPE
  1194.     SYNTAX      Counter32
  1195.     MAX-ACCESS  read-only
  1196.     STATUS      current
  1197.     DESCRIPTION
  1198.             "The number of responses of this type received by this
  1199.              entity."
  1200.     ::= { wwwResponseEntry 2 }
  1201.  
  1202. wwwResponseInControlBytes OBJECT-TYPE
  1203.     SYNTAX      Counter32
  1204.     MAX-ACCESS  read-only
  1205.     STATUS      current
  1206.     DESCRIPTION
  1207.             "The number of protocol control bytes of this type
  1208.              received by this entity."
  1209.     ::= { wwwResponseEntry 3 }
  1210.  
  1211. wwwResponseInContentBytes OBJECT-TYPE
  1212.     SYNTAX      Counter32
  1213.     MAX-ACCESS  read-only
  1214.     STATUS      current
  1215.     DESCRIPTION
  1216.             "The number of protocol content bytes received
  1217.  
  1218. Expires June 1, 1997                                      [Page 21]
  1219.  
  1220. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1221.              by this type of response by this entity."
  1222.     ::= { wwwResponseEntry 4 }
  1223.  
  1224. wwwResponseInLastTime OBJECT-TYPE
  1225.     SYNTAX      TimeStamp
  1226.     MAX-ACCESS  read-only
  1227.     STATUS      current
  1228.     DESCRIPTION
  1229.             "The value of sysUpTime when the last byte of the last
  1230.              complete response of this type was received by this
  1231.              entity."
  1232.     ::= { wwwResponseEntry 5 }
  1233.  
  1234. wwwResponseOutCount OBJECT-TYPE
  1235.     SYNTAX      Counter32
  1236.     MAX-ACCESS  read-only
  1237.     STATUS      current
  1238.     DESCRIPTION
  1239.             "The number of responses of this type generated by this
  1240.              entity."
  1241.     ::= { wwwResponseEntry 6 }
  1242.  
  1243. wwwResponseOutControlBytes OBJECT-TYPE
  1244.     SYNTAX      Counter32
  1245.     MAX-ACCESS  read-only
  1246.     STATUS      current
  1247.     DESCRIPTION
  1248.             "The number of protocol control bytes of this type
  1249.              generated by this entity."
  1250.     ::= { wwwResponseEntry 7 }
  1251.  
  1252. wwwResponseOutContentBytes OBJECT-TYPE
  1253.     SYNTAX      Counter32
  1254.     MAX-ACCESS  read-only
  1255.     STATUS      current
  1256.     DESCRIPTION
  1257.             "The number of protocol content bytes generated by this
  1258.       type of response by this entity."
  1259.     ::= { wwwResponseEntry 8 }
  1260.  
  1261. wwwResponseOutLastTime OBJECT-TYPE
  1262.     SYNTAX      TimeStamp
  1263.     MAX-ACCESS  read-only
  1264.     STATUS      current
  1265.     DESCRIPTION
  1266.             "The value of sysUpTime when the first byte of the
  1267.       last response of this type was sent by this entity."
  1268.     ::= { wwwResponseEntry 9 }
  1269.  
  1270. --
  1271. --  wwwDocument
  1272. --
  1273. --  This portion of the MIB defines objects for the document store.
  1274. --
  1275.  
  1276. Expires June 1, 1997                                      [Page 22]
  1277.  
  1278. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1279. --  The document store is view from two perspectives:
  1280. --
  1281. --    -as seen from clients of the entity from a service perspective
  1282. --    -as viewed by the collection of files in the filesystem
  1283. --
  1284. --  The first case is defined as a table of statistics as seen from
  1285. --  the service perspective. This wwwDocTable is indexed by applIndex
  1286. --  and a unique value for that entity for each document. The entries
  1287. --  in this table defines statistics and information from this service
  1288. --  perspective.
  1289. --
  1290. --  The second case is defined using the sysApplInstallPkgTable and the
  1291. --  sysApplInstallElmtTable. An entry in the sysApplInstallPkgTable can
  1292. --  be defined for the entire collection of document resources the
  1293. --  service provides, or any subset of those document resources. For
  1294. --  instance, an Internet service provider may configure a separate
  1295. --  entry in the sysApplInstallPkgTable for each customer on a server
  1296. --  supporting multiple virtual servers, for each user name of a
  1297. --  domain, etc.
  1298. --
  1299. --  Entries in the sysApplInstallElmtTable correspond to each file in
  1300. --  the filesystem which are mapped to entries in wwwDocTable. These
  1301. --  entries in sysApplInstallElmtTable may be loaded by the agent when
  1302. --  the file is first accessed, or be pre-loaded even with entries of
  1303. --  files that have never been accessed by the service.
  1304. --
  1305. --  The wwwDocNameTable provides a mapping from the name of the
  1306. --  document resource from the service perspective to the indices
  1307. --  of the wwwDocTable, the sysApplInstallPkgTable and the
  1308. --  sysApplInstallElmtTable.
  1309. --
  1310.  
  1311. wwwDocument        OBJECT IDENTIFIER ::= { wwwMIBObjects 3 }
  1312.  
  1313. --
  1314. --  wwwDocNameTable
  1315. --
  1316.  
  1317. -- [## Note that SMI limits the max. number of elements in an
  1318. --     object identifier to 128. This means that a wwwDocNameName is
  1319. --     more or less limited to 100 characters. ##]
  1320.  
  1321. wwwDocNameTable OBJECT-TYPE
  1322.     SYNTAX SEQUENCE OF WwwDocNameEntry
  1323.     MAX-ACCESS not-accessible
  1324.     STATUS current
  1325.     DESCRIPTION
  1326.       "The table of document name to index mappings. This table is
  1327.        provided so that if the document name is known, the index
  1328.        into the wwwDocTable can be obtained without having to
  1329.        traverse the entire wwwDocTable. Entries are indexed by
  1330.        the URL path without any possible arguments.
  1331.  
  1332.        If the value of wwwEntityName.1 is www.a.org, then the
  1333.  
  1334. Expires June 1, 1997                                      [Page 23]
  1335.  
  1336. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1337.        wwwDocTable entry for http://www.a.org/foo/bar.html can be
  1338.        obtained by retrieving
  1339.    wwwDocNameIndex.1.13.47.102.111.111.47.98.97.114.46.104.116.109.108"
  1340.     ::= {wwwDocument 1}
  1341.  
  1342. wwwDocNameEntry OBJECT-TYPE
  1343.     SYNTAX WwwDocNameEntry
  1344.     MAX-ACCESS not-accessible
  1345.     STATUS current
  1346.     DESCRIPTION
  1347.       "An entry associated with a particular mapping
  1348.        in the wwwDocNameTable."
  1349.     INDEX {applIndex, wwwDocNameName}
  1350.     ::= {wwwDocNameTable 1}
  1351.  
  1352. WwwDocNameEntry ::= SEQUENCE
  1353.     {
  1354.       wwwDocNameName     WwwDocName,
  1355.       wwwDocNameIndex    WwwDocIndex
  1356.     }
  1357.  
  1358. wwwDocNameName OBJECT-TYPE
  1359.     SYNTAX WwwDocName
  1360.     MAX-ACCESS not-accessible
  1361.     STATUS current
  1362.     DESCRIPTION
  1363.       "Auxilary object used along with applIndex to uniquely identify
  1364.        a wwwDocNameEntry for a wwwEntityEntry. applIndex is the table
  1365.        index value from the Network Services Monitoring MIB."
  1366.     ::= {wwwDocNameEntry 1}
  1367.  
  1368. wwwDocNameIndex OBJECT-TYPE
  1369.     SYNTAX WwwDocIndex
  1370.     MAX-ACCESS read-only
  1371.     STATUS current
  1372.     DESCRIPTION
  1373.       "A value that can be used along with applIndex to access the
  1374.        wwwDocNameName document information in the wwwDocTable.
  1375.        applIndex is the table index value from the Network Services
  1376.        Monitoring MIB."
  1377.     ::= {wwwDocNameEntry 2}
  1378.  
  1379. --
  1380. --  wwwDocFilterTable
  1381. --
  1382. wwwDocFilterTable OBJECT-TYPE
  1383.     SYNTAX SEQUENCE OF WwwDocFilterEntry
  1384.     MAX-ACCESS not-accessible
  1385.     STATUS current
  1386.     DESCRIPTION
  1387.       "This table is used to filter out entries that should not appear
  1388.        in the wwwDocNameTable. A document name is matched against the
  1389.        expressions listed in this table. A successful match will stop
  1390.        further processing of this entry so that this document name will
  1391.  
  1392. Expires June 1, 1997                                      [Page 24]
  1393.  
  1394. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1395.        not appear in the wwwDocNameTable."
  1396.     ::= { wwwDocument 2 }
  1397.  
  1398. wwwDocFilterEntry OBJECT-TYPE
  1399.     SYNTAX WwwDocFilterEntry
  1400.     MAX-ACCESS not-accessible
  1401.     STATUS current
  1402.     DESCRIPTION
  1403.       "An entry that filters documents that match a specific regular
  1404.        expression."
  1405.     INDEX { applIndex, wwwDocFilterIndex }
  1406.     ::= { wwwDocFilterTable 1}
  1407.  
  1408. WwwDocFilterEntry ::= SEQUENCE {
  1409.     wwwDocFilterIndex Integer32,
  1410.     wwwDocFilterRegexp DisplayString,
  1411.     wwwDocFilterStatus RowStatus
  1412. }
  1413.  
  1414. wwwDocFilterIndex OBJECT-TYPE
  1415.     SYNTAX      Integer32 (1..10000)
  1416.     MAX-ACCESS  not-accessible
  1417.     STATUS      current
  1418.     DESCRIPTION
  1419.       "An arbitrary integer used only for indexing purposes."
  1420.     ::= { wwwDocFilterEntry 1 }
  1421.  
  1422. wwwDocFilterRegexp OBJECT-TYPE
  1423.     SYNTAX      DisplayString
  1424.     MAX-ACCESS  read-create
  1425.     STATUS      current
  1426.     DESCRIPTION
  1427.       "A regular expression that is matched against the document
  1428.        name. [## Definition of a regular expression missing. ##]"
  1429.     ::= { wwwDocFilterEntry 2 }
  1430.  
  1431. wwwDocFilterStatus OBJECT-TYPE
  1432.     SYNTAX      RowStatus
  1433.     MAX-ACCESS  read-create
  1434.     STATUS      current
  1435.     DESCRIPTION
  1436.       "An object used to create and remove entries in the
  1437.        wwwDocFilterTable."
  1438.     ::= { wwwDocFilterEntry 3 }
  1439.  
  1440.  
  1441. --
  1442. --  wwwDocTable
  1443. --
  1444. --
  1445. --
  1446. --
  1447. wwwDocTable OBJECT-TYPE
  1448.     SYNTAX SEQUENCE OF WwwDocEntry
  1449.  
  1450. Expires June 1, 1997                                      [Page 25]
  1451.  
  1452. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1453.     MAX-ACCESS not-accessible
  1454.     STATUS current
  1455.     DESCRIPTION
  1456.       "The table of documents accessible from any entity configured
  1457.        in the wwwEntityTable. The agent minimally adds entries to this
  1458.        table to correspond with documents that have been accessed.
  1459.        It may choose to add entries for documents which have not yet
  1460.        been accessed as well."
  1461.     ::= { wwwDocument 3 }
  1462.  
  1463. wwwDocEntry OBJECT-TYPE
  1464.     SYNTAX WwwDocEntry
  1465.     MAX-ACCESS not-accessible
  1466.     STATUS current
  1467.     DESCRIPTION
  1468.       "An entry associated with a particular mapping in the
  1469.        wwwDocTable."
  1470.     INDEX {applIndex, wwwDocNameIndex, wwwDocTimeMark}
  1471.     ::= {wwwDocTable 1}
  1472.  
  1473. WwwDocEntry ::= SEQUENCE
  1474.     {
  1475.       wwwDocTimeMark                  TimeFilter,
  1476.       wwwDocInstallPkg                Integer32,
  1477.       wwwDocInstallElmt               Integer32,
  1478.       wwwDocName                      WwwDocName,
  1479.       wwwDocType                      WwwDocType,
  1480.       wwwDocFirstAccessTimeStamp      DateAndTime,
  1481.       wwwDocLastAccessTimeStamp       DateAndTime,
  1482.       wwwDocLastAccessResponseType    WwwResponseType,
  1483.       wwwDocInBytes                   ZeroBasedCounter32,
  1484.       wwwDocOutBytes                  ZeroBasedCounter32,
  1485.       wwwDocInCount                   ZeroBasedCounter32,
  1486.       wwwDocOutCount                  ZeroBasedCounter32,
  1487.       wwwDocSpecific                  OBJECT IDENTIFIER,
  1488.       wwwDocStatus                    RowStatus
  1489.     }
  1490.  
  1491. wwwDocTimeMark OBJECT-TYPE
  1492.     SYNTAX TimeFilter
  1493.     MAX-ACCESS not-accessible
  1494.     STATUS current
  1495.     DESCRIPTION
  1496.       "A TimeFilter for this entry by which the real accesses
  1497.        are counted between two sequential retrievals of this table.
  1498.        The TimeFilter is a textual convention in RMON-2,
  1499.        draft-ietf-rmonmib-rmonmib-v2-03.txt.
  1500.        For the appropriate behaviour is referred to that MIB.
  1501.        The values during startup time are exactly the same
  1502.        during the last actions of the HTTP-server before the
  1503.        server went down.
  1504.  
  1505.        [## we do not actually want to purge
  1506.        this table when sysUptime resets.  We need to consider
  1507.  
  1508. Expires June 1, 1997                                      [Page 26]
  1509.  
  1510. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1511.        whether this is still an acceptable use of TimeFilter.
  1512.        The reasoning is that we want these attributes to be
  1513.        maintained across restarts of the http software, the
  1514.        management software and the host computer.  In other words,
  1515.        we want the data in the table to be persistent. At the
  1516.        same time, since the table is likely very large, we want
  1517.        the ability to read the updates since a given time. I would
  1518.        prefer the following.  Rather than purging the table when
  1519.        sysUptime is zero (wrap or restart), return all entries in
  1520.        the table.  For instance wwwDocName.x.y.0 would return
  1521.        all documents for all valid values of x and y. ##]"
  1522.     ::= {wwwDocEntry 1}
  1523.  
  1524. -- [## A TC for this index has been requested from the application MIB
  1525. --     WG. If added, we should insure that 0 is in the valid range. ##]
  1526.  
  1527. wwwDocInstallPkg OBJECT-TYPE
  1528.     SYNTAX  Integer32 (0..'7fffffff'h)
  1529.     MAX-ACCESS read-only
  1530.     STATUS current
  1531.     DESCRIPTION
  1532.       "This value can be used to index into the sysApplInstallPkgTable
  1533.        which defines the documents for this wwwEntity. Entries in the
  1534.        sysApplInstallPkgTable can be allocated so that the documents
  1535.        that the web server provides are viewed as an installed package.
  1536.        There might be a single package for the entire server, a package
  1537.        for each virtual host on the server, or entries for each user.
  1538.        For instance, the documents that make up www.a.org could be
  1539.        viewed as a package. Additionally, users whose pages show up as
  1540.        www.a.org/~user could be separate packages or part of the main
  1541.        package. If there is no file on the filesystem which corresponds
  1542.        to this URL (for instance it is handled internally to the web
  1543.        server) and there is no corresponding  entry in the
  1544.        sysApplInstallPkgTable, then the value of this object is 0."
  1545.     ::= {wwwDocEntry 2}
  1546.  
  1547. -- [## A TC for this index has been requested from the application MIB
  1548. --     WG. If added, we should insure that 0 is in the valid range. ##]
  1549.  
  1550. wwwDocInstallElmt OBJECT-TYPE
  1551.     SYNTAX  Integer32 (0..'7fffffff'h)
  1552.     MAX-ACCESS read-only
  1553.     STATUS current
  1554.     DESCRIPTION
  1555.       "This value can be used along with the corresponding value for
  1556.        wwwDocNamePkg to index into the sysApplInstallElmtTable to find
  1557.        specific information about the representation of this document
  1558.        on the fileservers disk. The sysApplInstallPkgTable should
  1559.        contain an entry for every document, file, and script utilized
  1560.        by the web server, even if those entries correspond to items
  1561.        that have never been accessed. This means that there may be
  1562.        items in the sysApplInstallElmt tables that are not referenced
  1563.        from this table. If there is no corresponding file on the
  1564.        fileserver, then the value of this object is 0. This can occur
  1565.  
  1566. Expires June 1, 1997                                      [Page 27]
  1567.  
  1568. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1569.        if the URL is handled internally to the web server, or if all
  1570.        accesses to the URL indicate a failed requests such as document
  1571.        not found."
  1572.     ::= {wwwDocEntry 3}
  1573.  
  1574. wwwDocName OBJECT-TYPE
  1575.     SYNTAX WwwDocName
  1576.     MAX-ACCESS read-only
  1577.     STATUS current
  1578.     DESCRIPTION
  1579.       "The name of this document relative to the www entity
  1580.        name as seen from the web. For instance if the www
  1581.        entity name is www.a.org and this file is accessible
  1582.        on the web as http://www.a.org/foo.html, then the
  1583.        value of this object would be '/foo.html'."
  1584.     ::= {wwwDocEntry 4}
  1585.  
  1586. wwwDocType OBJECT-TYPE
  1587.     SYNTAX WwwDocType
  1588.     MAX-ACCESS read-only
  1589.     STATUS current
  1590.     DESCRIPTION
  1591.       "Indicates the type of the document. If the document is 'static',
  1592.        then the related sysApplInstallElmtSize refers to the size that
  1593.        is transmitted when this document is requested. If the document
  1594.        is 'dynamic', then the related sysApplInstallElmtSize is 0 and
  1595.        the amount of data transmitted on access is not known, but
  1596.        understood to be variable."
  1597.     ::= {wwwDocEntry 5}
  1598.  
  1599. wwwDocFirstAccessTimeStamp OBJECT-TYPE
  1600.     SYNTAX DateAndTime
  1601.     MAX-ACCESS read-only
  1602.     STATUS current
  1603.     DESCRIPTION
  1604.       "The date and time that this document was first accessed
  1605.        since being inserted into this table or being modified. If
  1606.        entries are inserted on access, then this also corresponds
  1607.        to the date and time of being placed into this table.  If
  1608.        entries are inserted into the table prior to being accessed,
  1609.        then this value should be all zero. When a document is accessed
  1610.        following being modified on the servers disk, this value is
  1611.        reset to the timestamp of such access. [## do we want to use
  1612.        the RowStatus 'notInService' to indicate rows that are
  1613.        inserted prior to use? ##]"
  1614.     ::= {wwwDocEntry 6}
  1615.  
  1616. wwwDocLastAccessTimeStamp OBJECT-TYPE
  1617.     SYNTAX DateAndTime
  1618.     MAX-ACCESS read-only
  1619.     STATUS current
  1620.     DESCRIPTION
  1621.       "The date and time that this document was last accessed."
  1622.     ::= {wwwDocEntry 7}
  1623.  
  1624. Expires June 1, 1997                                      [Page 28]
  1625.  
  1626. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1627.  
  1628. wwwDocLastAccessResponseType OBJECT-TYPE
  1629.     SYNTAX WwwResponseType
  1630.     MAX-ACCESS read-only
  1631.     STATUS current
  1632.     DESCRIPTION
  1633.       "The protocol response type which was sent to the client
  1634.        the last time this document was accessed."
  1635.     ::= {wwwDocEntry 8}
  1636.  
  1637. wwwDocInBytes OBJECT-TYPE
  1638.     SYNTAX ZeroBasedCounter32
  1639.     MAX-ACCESS read-only
  1640.     STATUS current
  1641.     DESCRIPTION
  1642.       "The number of bytes received by this entity while transporting
  1643.        references to this document."
  1644.     ::= {wwwDocEntry 9}
  1645.  
  1646. wwwDocOutBytes OBJECT-TYPE
  1647.     SYNTAX ZeroBasedCounter32
  1648.     MAX-ACCESS read-only
  1649.     STATUS current
  1650.     DESCRIPTION
  1651.       "The number of content bytes while transmitting this document."
  1652.     ::= {wwwDocEntry 10}
  1653.  
  1654. wwwDocInCount OBJECT-TYPE
  1655.     SYNTAX ZeroBasedCounter32
  1656.     MAX-ACCESS read-only
  1657.     STATUS current
  1658.     DESCRIPTION
  1659.       "The number of times this document has been received."
  1660.     ::= {wwwDocEntry 11}
  1661.  
  1662. wwwDocOutCount OBJECT-TYPE
  1663.     SYNTAX ZeroBasedCounter32
  1664.     MAX-ACCESS read-only
  1665.     STATUS current
  1666.     DESCRIPTION
  1667.       "The number of times this document has been transmitted."
  1668.     ::= {wwwDocEntry 12}
  1669.  
  1670. wwwDocSpecific OBJECT-TYPE
  1671.     SYNTAX OBJECT IDENTIFIER
  1672.     MAX-ACCESS read-only
  1673.     STATUS current
  1674.     DESCRIPTION
  1675.       "A reference to MIB definitions specific to the particular
  1676.        document being realized by this entry.  For example, if this
  1677.        entry corresponds to a CGI based URL, then this value might
  1678.        refer to a table specific to the usage of that URL with
  1679.        various parameter combinations. If this information is not
  1680.        present, its value should be set to the OBJECT IDENTIFIER
  1681.  
  1682. Expires June 1, 1997                                      [Page 29]
  1683.  
  1684. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1685.        { 0 0 }, which is a syntactically valid object identifier,
  1686.        and any conformant implementation of ASN.1 and BER must be
  1687.        able to generate and recognize this value. Agents that do
  1688.        not support any extensions return { 0 0 } for all entries
  1689.        in this table. [## Is this a sufficient way to allow extension
  1690.        to support parameters? ##]"
  1691.     ::= {wwwDocEntry 13}
  1692.  
  1693. wwwDocStatus OBJECT-TYPE
  1694.     SYNTAX RowStatus
  1695.     MAX-ACCESS read-write
  1696.     STATUS current
  1697.     DESCRIPTION
  1698.       "The status of this row.  Rows are added to this table by the
  1699.        agent, normally when a resource is first requested. Writing
  1700.        'Destroy' to this object removes this entry from the
  1701.        wwwDocTable as well as removing the associated entry in the
  1702.        wwwDocNameTable. No other value is supported."
  1703.     ::= {wwwDocEntry 14}
  1704.  
  1705.  
  1706. --
  1707. --  wwwError
  1708. --
  1709. --  Objects which define error reporting conditions
  1710. --
  1711. wwwError        OBJECT IDENTIFIER ::= { wwwMIBObjects 4 }
  1712.  
  1713. --
  1714. --  wwwAppl
  1715. --
  1716. --  Objects which extend sysApplMIB/applMIB framework
  1717. --
  1718. wwwAppl            OBJECT IDENTIFIER ::= { wwwMIBObjects 5 }
  1719. wwwApplInstalled   OBJECT IDENTIFIER ::= { wwwAppl 1 }
  1720. wwwApplRun         OBJECT IDENTIFIER ::= { wwwAppl 2 }
  1721.  
  1722. --
  1723. --  wwwApplInstallPkgTable
  1724. --
  1725. wwwApplInstallPkgTable OBJECT-TYPE
  1726.        SYNTAX      SEQUENCE OF WwwApplInstallPkgEntry
  1727.        MAX-ACCESS  not-accessible
  1728.        STATUS      current
  1729.        DESCRIPTION
  1730.            "The table listing the www software application packages
  1731.            installed on a host computer. In order to appear in
  1732.            this table, it may be necessary for the application
  1733.            to be installed using some type of software
  1734.            installation mechanism or global registry so that its
  1735.            existence can be detected by the agent implementation.
  1736.  
  1737.            This table extends the sysApplInstallPkgTable of the
  1738.            sysApplMib/applMib framework with attributes specific
  1739.  
  1740. Expires June 1, 1997                                      [Page 30]
  1741.  
  1742. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1743.            to www applications."
  1744.        ::= { wwwApplInstalled 1 }
  1745.  
  1746. wwwApplInstallPkgEntry OBJECT-TYPE
  1747.        SYNTAX      WwwApplInstallPkgEntry
  1748.        MAX-ACCESS  not-accessible
  1749.        STATUS      current
  1750.        DESCRIPTION
  1751.            "The logical row describing an installed www application
  1752.            package."
  1753.        INDEX    { sysApplInstallPkgIndex }
  1754.        ::= { wwwApplInstallPkgTable 1 }
  1755.  
  1756. WwwApplInstallPkgEntry ::= SEQUENCE
  1757.    {
  1758.        wwwApplInstallPkgBogus Integer32
  1759.    }
  1760.  
  1761. wwwApplInstallPkgBogus OBJECT-TYPE
  1762.     SYNTAX Integer32
  1763.     MAX-ACCESS read-only
  1764.     STATUS current
  1765.     DESCRIPTION
  1766.       "A place holder to satisfy the MIB compiler."
  1767.     ::= { wwwApplInstallPkgEntry 1}
  1768.  
  1769. --
  1770. -- wwwApplInstallElmtTable
  1771. --
  1772. wwwApplInstallElmtTable OBJECT-TYPE
  1773.        SYNTAX      SEQUENCE OF WwwApplInstallElmtEntry
  1774.        MAX-ACCESS  not-accessible
  1775.        STATUS      current
  1776.        DESCRIPTION
  1777.            "This table details the individual application package
  1778.            elements (files and executables) which comprise the
  1779.            www applications defined in the wwwApplInstallPkgTable.
  1780.  
  1781.            Table entries are indexed by sysApplInstallPkgIndex,
  1782.            sysApplInstallElmtIndex to facilitate retrieval of
  1783.            all elements associated with a particular installed
  1784.            application package.
  1785.  
  1786.            This table extends the sysApplInstallElmtTable of the
  1787.            sysApplMib/applMib framework with attributes specific
  1788.            to www applications."
  1789.        ::= { wwwApplInstalled 2 }
  1790.  
  1791. wwwApplInstallElmtEntry OBJECT-TYPE
  1792.        SYNTAX      WwwApplInstallElmtEntry
  1793.        MAX-ACCESS  not-accessible
  1794.        STATUS      current
  1795.        DESCRIPTION
  1796.            "The logical row describing an element of an installed
  1797.  
  1798. Expires June 1, 1997                                      [Page 31]
  1799.  
  1800. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1801.            www application. The element may be an executable or
  1802.            non-executable file."
  1803.        INDEX    {sysApplInstallPkgIndex, sysApplInstallElmtIndex}
  1804.        ::= { wwwApplInstallElmtTable 1 }
  1805.  
  1806. WwwApplInstallElmtEntry ::= SEQUENCE
  1807.    {
  1808.  wwwApplInstallElmtBogus    Integer32
  1809.    }
  1810.  
  1811. wwwApplInstallElmtBogus OBJECT-TYPE
  1812.     SYNTAX Integer32
  1813.     MAX-ACCESS read-only
  1814.     STATUS current
  1815.     DESCRIPTION
  1816.       "A place holder to satisfy the MIB compiler."
  1817.     ::= { wwwApplInstallElmtEntry 1}
  1818.  
  1819.  
  1820. --
  1821. -- wwwApplRunTable
  1822. --
  1823. wwwApplRunTable OBJECT-TYPE
  1824.        SYNTAX      SEQUENCE OF WwwApplRunEntry
  1825.        MAX-ACCESS  not-accessible
  1826.        STATUS      current
  1827.        DESCRIPTION
  1828.            "The table describes the www applications which are
  1829.            executing on the host.  Each time an application is
  1830.            invoked, an entry is created in this table. When an
  1831.            application ends, the entry is removed from this table and
  1832.            placed in the wwwApplPastRunTable. Note that the
  1833.            corresponding entry in sysApplRunTable is moved to
  1834.            sysAPplPastRunTable at the same time.
  1835.  
  1836.            The table is indexed by sysApplInstallPkgIndex,
  1837.            sysApplRunIndex to enable managers to easily locate all
  1838.            invocations of a particular application package.
  1839.  
  1840.            This table extends the sysApplRunTable of the
  1841.            sysApplMib/applMib framework with attributes specific
  1842.            to www applications."
  1843.        ::= { wwwApplRun 1 }
  1844.  
  1845. wwwApplRunEntry OBJECT-TYPE
  1846.        SYNTAX      WwwApplRunEntry
  1847.        MAX-ACCESS  not-accessible
  1848.        STATUS      current
  1849.        DESCRIPTION
  1850.            "The logical row describing a www application which is
  1851.            currently running on this host."
  1852.        INDEX    { sysApplInstallPkgIndex, sysApplRunIndex }
  1853.        ::= { wwwApplRunTable   1 }
  1854.  
  1855.  
  1856. Expires June 1, 1997                                      [Page 32]
  1857.  
  1858. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1859. WwwApplRunEntry ::= SEQUENCE {
  1860.  wwwApplRunBogus    Integer32
  1861.    }
  1862.  
  1863. wwwApplRunBogus OBJECT-TYPE
  1864.     SYNTAX Integer32
  1865.     MAX-ACCESS read-only
  1866.     STATUS current
  1867.     DESCRIPTION
  1868.       "A place holder to satisfy the MIB compiler."
  1869.     ::= { wwwApplRunEntry 1}
  1870.  
  1871. --
  1872. -- wwwApplPastRunTable
  1873. --
  1874. wwwApplPastRunTable OBJECT-TYPE
  1875.        SYNTAX      SEQUENCE OF WwwApplPastRunEntry
  1876.        MAX-ACCESS  not-accessible
  1877.        STATUS      current
  1878.        DESCRIPTION
  1879.            "A history of the www applications that have previously run
  1880.            on the host computer.  An entry is moved to this table
  1881.            from the wwwApplRunTable when the invoked application
  1882.            represented by the entry ceases to be running.
  1883.  
  1884.            Entries remain in this table until they are aged out when
  1885.            either the table size reaches a maximum as determined by
  1886.            the sysApplPastRunMaxRows, or when an entry has aged to
  1887.            exceed a time limit as set by sysApplPastRunTblTimeLimit.
  1888.  
  1889.            Entries in this table are indexed by sysApplInstallPkgIndex,
  1890.            sysApplPastRunIndex to facilitate retrieval of all past
  1891.            run invocations of a particular installed application.
  1892.  
  1893.            This table extends the sysApplPastRunTable of the
  1894.            sysApplMib/applMib framework with attributes specific
  1895.            to www applications."
  1896.        ::= { wwwApplRun 2 }
  1897.  
  1898. wwwApplPastRunEntry OBJECT-TYPE
  1899.        SYNTAX      WwwApplPastRunEntry
  1900.        MAX-ACCESS  not-accessible
  1901.        STATUS      current
  1902.        DESCRIPTION
  1903.            "The logical row describing an invocation of a www
  1904.            application which was previously run and has terminated.
  1905.            The entry is basically copied from the wwwApplRunTable
  1906.            when the application instance terminates.  Hence, the
  1907.            entry's value for sysApplPastRunIndex is the same as its
  1908.            value was for sysApplRunIndex."
  1909.        INDEX    { sysApplInstallPkgIndex, sysApplPastRunIndex }
  1910.        ::= { wwwApplPastRunTable 1 }
  1911.  
  1912. WwwApplPastRunEntry ::= SEQUENCE
  1913.  
  1914. Expires June 1, 1997                                      [Page 33]
  1915.  
  1916. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1917.    {
  1918.         wwwApplPastRunBogus        Integer32
  1919.    }
  1920.  
  1921. wwwApplPastRunBogus OBJECT-TYPE
  1922.     SYNTAX Integer32
  1923.     MAX-ACCESS read-only
  1924.     STATUS current
  1925.     DESCRIPTION
  1926.       "A place holder to satisfy the MIB compiler."
  1927.     ::= { wwwApplPastRunEntry 1}
  1928.  
  1929. --
  1930. -- wwwApplElmtRunTable
  1931. --
  1932. wwwApplElmtRunTable OBJECT-TYPE
  1933.        SYNTAX      SEQUENCE OF WwwApplElmtRunEntry
  1934.        MAX-ACCESS  not-accessible
  1935.        STATUS      current
  1936.        DESCRIPTION
  1937.            "The table describes the processes which are
  1938.            currently executing on the host system which are
  1939.            associated with an invoked www application.
  1940.  
  1941.            The table is indexed by sysApplElmtRunInvocID,
  1942.            sysApplElmtRunIndex to make it easy to locate all running
  1943.            elements of a particular invoked application.
  1944.  
  1945.            This table extends the sysApplElmtRunTable of the
  1946.            sysApplMib/applMib framework with attributes specific
  1947.            to www applications."
  1948.        ::= { wwwApplRun 3 }
  1949.  
  1950. wwwApplElmtRunEntry OBJECT-TYPE
  1951.        SYNTAX      WwwApplElmtRunEntry
  1952.        MAX-ACCESS  not-accessible
  1953.        STATUS      current
  1954.        DESCRIPTION
  1955.            "The logical row describing a process currently
  1956.            running on this host which is associated with an
  1957.            invoked www application."
  1958.        INDEX    { sysApplElmtRunInvocID, sysApplElmtRunIndex }
  1959.        ::= { wwwApplElmtRunTable   1 }
  1960.  
  1961. WwwApplElmtRunEntry ::= SEQUENCE
  1962.    {
  1963.         wwwApplElmtRunBogus    Integer32
  1964.    }
  1965.  
  1966. wwwApplElmtRunBogus OBJECT-TYPE
  1967.     SYNTAX Integer32
  1968.     MAX-ACCESS read-only
  1969.     STATUS current
  1970.     DESCRIPTION
  1971.  
  1972. Expires June 1, 1997                                      [Page 34]
  1973.  
  1974. INTERNET DRAFT                 WWW MIB                December 1, 1996
  1975.       "A place holder to satisfy the MIB compiler."
  1976.     ::= { wwwApplElmtRunEntry 1}
  1977.  
  1978. --
  1979. -- wwwApplElmtPastRunTable
  1980. --
  1981. wwwApplElmtPastRunTable OBJECT-TYPE
  1982.        SYNTAX      SEQUENCE OF WwwApplElmtPastRunEntry
  1983.        MAX-ACCESS  not-accessible
  1984.        STATUS      current
  1985.        DESCRIPTION
  1986.            "The table describes the processes which have previously
  1987.            executed on the host system as part of a www application.
  1988.  
  1989.            Entries are added to this table when the corresponding
  1990.            process in the wwwApplElmtRun Table terminates. Just as
  1991.            the sysApplElmtRun entry is copied to sysApplElmtPastRun,
  1992.            the wwwApplElmtRun entry is copied to wwwApplElmntPastRun.
  1993.  
  1994.            Entries remain in this table until they are aged out when
  1995.            either the number of entries in the table reaches a
  1996.            maximum as determined by sysApplElmtPastRunMaxRows, or
  1997.            when an entry has aged to exceed a time limit as set by
  1998.            sysApplElmtPastRunTblTimeLimit.  When aging out entries,
  1999.            the oldest entry, as determined by the value of
  2000.            sysApplElmtPastRunTimeEnded, will be removed first.
  2001.  
  2002.            The table is indexed by sysApplElmtPastRunInvocID,
  2003.            sysApplElmtPastRunIndex to make it easy to locate all
  2004.            previously executed processes of a particular invoked
  2005.            application.
  2006.  
  2007.            This table extends the sysApplElmtPastRunTable of the
  2008.            sysApplMib/applMib framework with attributes specific
  2009.            to www applications."
  2010.        ::= { wwwApplRun 4 }
  2011.  
  2012. wwwApplElmtPastRunEntry OBJECT-TYPE
  2013.        SYNTAX      WwwApplElmtPastRunEntry
  2014.        MAX-ACCESS  not-accessible
  2015.        STATUS      current
  2016.        DESCRIPTION
  2017.            "The logical row describing a process which was
  2018.            previously executed on this host as part of a
  2019.            www application.  The entry is basically copied
  2020.            from the wwwApplElmtRunTable when the process
  2021.            terminates.  Hence, the entry's value for
  2022.            sysApplElmtPastRunIndex is the same as its value
  2023.            was for sysApplElmtRunIndex.  Only those
  2024.            processes which could be associated with an
  2025.            identified application are included in this table."
  2026.        INDEX    { sysApplElmtPastRunInvocID, sysApplElmtPastRunIndex }
  2027.        ::= { wwwApplElmtPastRunTable   1 }
  2028.  
  2029.  
  2030. Expires June 1, 1997                                      [Page 35]
  2031.  
  2032. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2033. WwwApplElmtPastRunEntry ::= SEQUENCE
  2034.    {
  2035.         wwwApplElmtPastRunBogus        Integer32
  2036.    }
  2037.  
  2038. wwwApplElmtPastRunBogus OBJECT-TYPE
  2039.     SYNTAX Integer32
  2040.     MAX-ACCESS read-only
  2041.     STATUS current
  2042.     DESCRIPTION
  2043.       "A place holder to satisfy the MIB compiler."
  2044.     ::= { wwwApplElmtPastRunEntry 1}
  2045.  
  2046. --
  2047. --  wwwRelate
  2048. --
  2049. --  Objects which define relationships to other MIB modules.
  2050. --
  2051. wwwRelate        OBJECT IDENTIFIER ::= { wwwMIBObjects 6 }
  2052.  
  2053. --
  2054. --
  2055. -- Conformance and compliance definitions.
  2056. --
  2057. --
  2058. wwwMIBEntityGroup OBJECT-GROUP
  2059.     OBJECTS
  2060.         {
  2061.         wwwEntityDescription,
  2062.         wwwEntityContact,
  2063.         wwwEntityProtocol,
  2064.         wwwEntityProtocolVersion,
  2065.         wwwEntityName,
  2066.         wwwEntityAddress,
  2067.         wwwEntityType
  2068.         }
  2069.     STATUS  current
  2070.     DESCRIPTION
  2071.             ""
  2072.     ::= { wwwMIBGroups 1 }
  2073.  
  2074. wwwMIBSummaryGroup OBJECT-GROUP
  2075.     OBJECTS
  2076.         {
  2077.         wwwSummaryInRequests,
  2078.         wwwSummaryOutRequests,
  2079.         wwwSummaryRequestErrors,
  2080.         wwwSummaryRequestDiscards,
  2081.         wwwSummaryInResponses,
  2082.         wwwSummaryOutResponses,
  2083.         wwwSummaryResponseDiscards,
  2084.         wwwSummaryInUnknowns,
  2085.         wwwSummaryInControlBytes,
  2086.         wwwSummaryInContentBytes,
  2087.  
  2088. Expires June 1, 1997                                      [Page 36]
  2089.  
  2090. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2091.         wwwSummaryOutControlBytes,
  2092.         wwwSummaryOutContentBytes
  2093.         }
  2094.     STATUS  current
  2095.     DESCRIPTION
  2096.             ""
  2097.     ::= { wwwMIBGroups 2 }
  2098.  
  2099. wwwMIBRequestGroup OBJECT-GROUP
  2100.     OBJECTS
  2101.         {
  2102.         wwwRequestInCount,
  2103.         wwwRequestInControlBytes,
  2104.         wwwRequestInContentBytes,
  2105.         wwwRequestInLastTime,
  2106.         wwwRequestOutCount,
  2107.         wwwRequestOutControlBytes,
  2108.         wwwRequestOutContentBytes,
  2109.         wwwRequestOutLastTime
  2110.         }
  2111.     STATUS  current
  2112.     DESCRIPTION
  2113.             ""
  2114.     ::= { wwwMIBGroups 3 }
  2115.  
  2116. wwwMIBResponseGroup OBJECT-GROUP
  2117.     OBJECTS
  2118.         {
  2119.         wwwResponseInCount,
  2120.         wwwResponseInControlBytes,
  2121.         wwwResponseInContentBytes,
  2122.         wwwResponseInLastTime,
  2123.         wwwResponseOutCount,
  2124.         wwwResponseOutControlBytes,
  2125.         wwwResponseOutContentBytes,
  2126.         wwwResponseOutLastTime
  2127.         }
  2128.     STATUS  current
  2129.     DESCRIPTION
  2130.             ""
  2131.     ::= { wwwMIBGroups 4 }
  2132.  
  2133. wwwMIBDocumentGroup OBJECT-GROUP
  2134.     OBJECTS
  2135.         {
  2136.         wwwDocNameIndex,
  2137.  wwwDocFilterRegexp,
  2138.  wwwDocFilterStatus,
  2139.         wwwDocInstallPkg,
  2140.         wwwDocInstallElmt,
  2141.         wwwDocName,
  2142.         wwwDocType,
  2143.         wwwDocFirstAccessTimeStamp,
  2144.         wwwDocLastAccessTimeStamp,
  2145.  
  2146. Expires June 1, 1997                                      [Page 37]
  2147.  
  2148. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2149.         wwwDocLastAccessResponseType,
  2150.         wwwDocInBytes,
  2151.         wwwDocOutBytes,
  2152.         wwwDocInCount,
  2153.         wwwDocOutCount,
  2154.         wwwDocSpecific,
  2155.         wwwDocStatus
  2156.         }
  2157.     STATUS  current
  2158.     DESCRIPTION
  2159.             ""
  2160.     ::= { wwwMIBGroups 5 }
  2161.  
  2162. -- wwwMIBRelateGroup OBJECT-GROUP
  2163. --    OBJECTS
  2164. --        {
  2165. --        }
  2166. --    STATUS  current
  2167. --    DESCRIPTION
  2168. --            ""
  2169. --    ::= { wwwMIBGroups 6 }
  2170.  
  2171. wwwMIBApplGroup OBJECT-GROUP
  2172.     OBJECTS
  2173.         {
  2174.        wwwApplInstallPkgBogus,
  2175.        wwwApplInstallElmtBogus,
  2176.        wwwApplRunBogus,
  2177.        wwwApplPastRunBogus,
  2178.        wwwApplElmtRunBogus,
  2179.        wwwApplElmtPastRunBogus
  2180.         }
  2181.     STATUS  current
  2182.     DESCRIPTION
  2183.             ""
  2184.     ::= { wwwMIBGroups 7 }
  2185.  
  2186.  
  2187. --
  2188. -- [## need to define remaining attributes here. ##]
  2189. --
  2190.  
  2191. wwwCompliance MODULE-COMPLIANCE
  2192.     STATUS  current
  2193.     DESCRIPTION
  2194.             "The compliance statement for SNMP entities
  2195.              which implement the WWW-MIB."
  2196.     MODULE  -- this module
  2197.         MANDATORY-GROUPS
  2198.                 {
  2199.                 wwwMIBEntityGroup,
  2200.                 wwwMIBSummaryGroup,
  2201.                 wwwMIBRequestGroup,
  2202.                 wwwMIBResponseGroup,
  2203.  
  2204. Expires June 1, 1997                                      [Page 38]
  2205.  
  2206. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2207.                 wwwMIBDocumentGroup,
  2208. --                wwwMIBRelateGroup,
  2209.   wwwMIBApplGroup
  2210.                 }
  2211.     ::= { wwwMIBCompliances 1 }
  2212.  
  2213. END
  2214.  
  2215.  
  2216. 11. Verification
  2217.  
  2218. The MIB module is verified using the SMICng MIB compiler by
  2219. Dave Perkins.  The following include file can be used along
  2220. with the SMICng compiler. Besides the standard MIBs released
  2221. with the SMICng distribution, the RMON2-MIB and SYSAPPL-MIB
  2222. are require for the compilation.
  2223.  
  2224. 11.1. SMICng Include File
  2225.  
  2226.  
  2227. 12. References
  2228.  
  2229.  [] Kalbfleisch, C., "Applicability of Standards Track MIBs to
  2230.      Management of World Wide Web Servers", RFC-2039, OnRamp
  2231.      Technologies, November 1996
  2232.  
  2233.  [] Anonymous, "Logging in the W3C httpd",
  2234.      http://www.w3.org/hypertext/WWW/Daemon/User/Config/Logging.html,
  2235.      W3C, July 1995
  2236.  
  2237.  [] McCloghrie, K., and M. Rose, Editors, "Management Information
  2238.      Base for Network Management of TCP/IP-based internets: MIB-
  2239.      II", STD 17, RFC 1213, Hughes LAN Systems, Performance
  2240.      Systems International, March 1991.
  2241.  
  2242.  [] Grillo, P., and S. Waldbusser, "Host Resources MIB", RFC 1514,
  2243.      Network Innovations, Intel Corporation, Carnegie Mellon
  2244.      University, September 1993
  2245.  
  2246.  [] Kille, S., and N. Freed, "Network Services Monitoring MIB",
  2247.      RFC 1565, ISODE Consortium, Innosoft, January 1994
  2248.  
  2249.  [] Saperia, J., C. Krupczak, R. Sturm, and J. Weinstock, "Definition
  2250.      of Managed Objects for Applications",
  2251.      draft-ietf-applmib-sysapplmib-02.txt, BGS Systems, Empire
  2252.      Technologies, Enterprise Management Professional Services,
  2253.      Bellcore, May 1996
  2254.  
  2255.  [] Krupczak, C. and S. Waldbusser, "Applicability of Host Resources
  2256.      MIB to Application Management", Empire Technologies, Inc.,
  2257.      International Network Services, October 1995.
  2258.  
  2259.  [] Kille, S., and N. Freed, "Mail Monitoring MIB", RFC 1566, ISODE
  2260.      Consortium, Innosoft, January 1994
  2261.  
  2262. Expires June 1, 1997                                      [Page 39]
  2263.  
  2264. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2265.  
  2266.  [] Mansfield, G., and S. Kille, "X.500 Directory Monitoring MIB",
  2267.      RFC 1567, AIC Systems Laboratory, ISODE Consortium, January 1994
  2268.  
  2269.  [] Postel, J., and Reynolds, J.K., "File TransferProtocol (FTP).",
  2270.      RFC 959, USC/ISI, October 1985.
  2271.  
  2272.  [] Kantor, B., and P. Lapsley, "Network News Transfer Protocol: A
  2273.    Proposed Standard for the Stream-Based Transmission of News", RFC
  2274.    977, UC San Diego & UC Berkeley, February 1986.
  2275.  
  2276.  [] Horton, M., and R. Adams, "Standard for interchange of USENET
  2277.    messages", RFC 1036, AT&T Bell Laboratories, Center for Seismic
  2278.    Studies, December 1987.
  2279.  
  2280.  [## Addition references are needed here for RMON-2, FTP, NNTP, GOPHER,
  2281.      WAIS, HTTP 1.1 ##]
  2282.  
  2283. 13. Acknowledgments
  2284.  
  2285.   This document was produced by the Application MIB working group and
  2286.   the members of the http-mib@onramp.net mailing list.
  2287.  
  2288.   The authors gratefully acknowledges the comments of the following
  2289.   individuals:
  2290.  
  2291.              Randy Preshun
  2292.              John Saperia
  2293.              Cheryl Krupczak
  2294.  
  2295. 14. Security Considerations
  2296.  
  2297.   Security issues are not discussed in this memo.
  2298.  
  2299. 15. Appendix - Applicability to other services
  2300.  
  2301.   This MIB is defined solely for the management of WWW servers, clients
  2302.   and proxies. It is realized however that the MIB may be directly
  2303.   applicable to other network information retrieval services. This
  2304.   appendix outlines how the MIB might be utilized for a number of
  2305.   other services. This may or may not provide the desired level of
  2306.   management of these types of applications. In some instances, a
  2307.   separate MIB may need to be defined for the service.
  2308.  
  2309. 15.1. FTP
  2310.  
  2311.   The File Transfer Protocol allows people to transfer file from one
  2312.   system to another system. The protocol is connection-oriented
  2313.   established by TCP. The client is responsible to generate requests
  2314.   and interpreted the responses from the server.
  2315.   The server interpreted requests and generate responses.
  2316.  
  2317.   The protocol consists two channels:
  2318.  
  2319.  
  2320. Expires June 1, 1997                                      [Page 40]
  2321.  
  2322. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2323.   o Control connection on which the traffic consists of service
  2324.     commands (the requests) and of replies (responses). The service
  2325.     commands reflect the operations such as the authentication
  2326.     (login-procedure), the actual file transfer and the
  2327.     logout-procedure. The replies are used to ensure the
  2328.     synchronisation of requests, actions in the file transfer process
  2329.     and guarantee that the user always knows the current state of the
  2330.     server. There is at least one reply to each service command.
  2331.  
  2332.   o Data connection on which the actual data transfer takes place.
  2333.  
  2334.   The mapping of an FTP-entity onto the WWW-MIB is straight forward.
  2335.   Global and administrative FTP-entity information can be mapped onto
  2336.   the entity table. The network traffic can be map onto the tables
  2337.   in the statistics group whereby the service commands are mapped on
  2338.   requests and the replies are mapped on responses. With respect to the
  2339.   byte counters the bytes transferred in the control connection is
  2340.   counted in the HeaderByte counters and the bytes transferred at the
  2341.   data connection is counted in the DataByte counters. The parameters
  2342.   with respect to the transferred files can be mapped onto the document
  2343.   table.
  2344.  
  2345.  
  2346. 15.2. NNTP
  2347.  
  2348.   The Network News Transfer Protocol is used for distribution,
  2349.   inquiry, retrieval, and posting of news articles. The news articles
  2350.   are stored in a central database allowing a subscriber to select
  2351.   only those items he wishes to read. Indexing, cross-referencing,
  2352.   and expiration of aged messages are also provided.
  2353.  
  2354.   The protocol consists of the same Request/Response paradigm like
  2355.   HTTP and FTP. Commands are given as requests and can be followed by
  2356.   parameters. The responses consist of two different types, a status
  2357.   response and a text responses.
  2358.  
  2359.   The mapping of a NNTP-entity is a little more complex than FTP,
  2360.   but still possible. Global and administrative information can be
  2361.   mapped onto the entity table. The network traffic can be map onto
  2362.   the tables in the statistics group whereby the commands are mapped
  2363.   on the requests and the status responses are mapped on the responses.
  2364.   The implementor should take special care of the mapping of the byte
  2365.   counters. All 'ControlByte' counters are counting the bytes which are
  2366.   not the body part of a message. The body part bytes has to be mapped
  2367.   onto the 'DataByte' counters. For details about the syntax of a
  2368.   message is referred to RFC 1036 [## ref TBD ##]. The text responses
  2369.   has to be mapped on the document table by seeing them as the
  2370.   transferred information.
  2371.  
  2372. 15.3. GOPHER
  2373.  
  2374.   The Gopher protocol is a distributed document search and retrieval
  2375.   protocol and is also based on the Request/Response paradigm.
  2376.   The protocol is stateless whereby faults the user does not force
  2377.  
  2378. Expires June 1, 1997                                      [Page 41]
  2379.  
  2380. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2381.   to start over.
  2382.  
  2383.   Clients with the Gopher protocol connect themselves to servers
  2384.   and generate requests. The servers respond with the requested
  2385.   informations which is displayed by the gopher client. This type
  2386.   of interaction in gopher is called transactions.
  2387.  
  2388.   The commands within gopher are determined by the server, because
  2389.   he responds with the information of which command is used for a
  2390.   particular information retrieval command. This feature gives gopher
  2391.   a wide variaty of possible commands.
  2392.  
  2393.   The mapping of the Gopher entity is almost straight forward. Global
  2394.   and administrative information can be mapped onto the entity table.
  2395.   The network traffic needs special attention to map it onto the tables
  2396.   in the statistics group whereby the transaction of the message
  2397.   towards the server is mapped on the requests and the transaction
  2398.   message coming from the server is mapped on the responses. Although
  2399.   the variaty of requests can be enormous the mapping can be done
  2400.   straight forward, but if requests are directly getting documents
  2401.   you can map them in the document table. For this MIB it is preferred
  2402.   to map them on the responses.
  2403.  
  2404. 15.4. WAIS
  2405.  
  2406.   [## TBD ##]
  2407.  
  2408. 15.5. Archie
  2409.  
  2410.   [## TBD ##]
  2411.  
  2412. 16. Appendix - Todo List
  2413.  
  2414.   [## This section will be removed when the document is complete
  2415.   because all items that are "to do" will have been done! ##]
  2416.  
  2417. 16.1. Resolve wwwDocName usage and TC definition
  2418.   The wwwDocNameName value likely needs to be limited to around 100
  2419.   bytes in length because it is an index. The wwwDocName could however
  2420.   represent a longer number of bytes.  One option is to define it as
  2421.   OCTET STRING so it can be as long as necessary, but rfc-1902
  2422.   indicates there may be interoperability issues with OCTET STRING
  2423.   greater than 255 bytes.
  2424.  
  2425. 16.2. Terminology
  2426.   Flush out section on terminology
  2427.  
  2428. 16.3. Handle illegal index values
  2429.   Determine what to do with illegal index values for pointers to
  2430.   other tables, specifically for sysAppl.
  2431.  
  2432. 16.4. Handle NSM to sysApplMIB relationship
  2433.   Determine where nsmToSysApplElmtRunTable should be defined.
  2434.   Options appear to be sysApplMIB, this MIB or a separate document.
  2435.  
  2436. Expires June 1, 1997                                      [Page 42]
  2437.  
  2438. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2439.   Currently the definition has been moved to applMib.
  2440.  
  2441. 16.5. Handle applIndex
  2442.   Currently the wwwEntityTable is indexed with applIndex from
  2443.   NSM. This causes potential problems in certain implementations and
  2444.   configuration if the WWW-MIB implementer does not implement the
  2445.   applTable and on the same machine an NSM agent is provided by
  2446.   the OS or other vendor. In this case, there is potential for
  2447.   applTable indexes to conflict with wwwEntityTable indexes which
  2448.   do not actually extend the applTable information. The NSM indicates
  2449.   it is to be the base for all network service applications.  WWW-MIB
  2450.   clearly fits this definition. Unfortunately, a number of implementers
  2451.   have indicated that they do not plan to implement NSM. So, the
  2452.   options seem to be to clearly document the situation and perhaps
  2453.   propose some suggested index values for applIndex in the
  2454.   wwwEntityTable, or require NSM to be implemented. The document
  2455.   currently indicates that "wording" for the applIndex usage in
  2456.   wwwEntityTable needs to be defined.
  2457.  
  2458.   The editor beleive that the applIndex should be used for this table
  2459.   and that either the applTable should be required, or index values
  2460.   should be suggested for the wwwEntityTable such that conflicts can
  2461.   be avoided.
  2462.  
  2463. 16.6. Identify attributes for sysAppl framework
  2464.   Currently a skeleton of tables has been defined that extend the
  2465.   sysAppl/applMib framework. The idea is that the sysAppl framework
  2466.   will apply to a portion of the MIB. Attributes that are desired
  2467.   for www, but not defined in either sysAppl or applMib will be
  2468.   placed within these skeleton tables.
  2469.  
  2470. 16.7. Regular Expression
  2471.   Pick as standard definition for regular expressions for the
  2472.   wwwDocFilter.
  2473.  
  2474. 16.8. Proxy Entity
  2475.   Determine additional attributes that are needed to handle proxy in
  2476.   terms of an entity.
  2477.  
  2478. 16.9. Proxy Documents
  2479.   Determine whether the represenation of the wwwDoc tables is
  2480.   sufficient or necessary for proxy.
  2481.  
  2482. 16.10. Handle all [##...##]
  2483.   Remove and resolve all [##...##] notation.
  2484.  
  2485. 17. Authors' Address
  2486.  
  2487.   Carl W. Kalbfleisch
  2488.   OnRamp Technologies, Inc.
  2489.   Email: cwk@onramp.net
  2490.   1950 Stemmons Frwy
  2491.   2026 INFOMART
  2492.   Dallas, TX 75207
  2493.  
  2494. Expires June 1, 1997                                      [Page 43]
  2495.  
  2496. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2497.   USA                                 Tel: (214) 672-7246
  2498.   cwk@onramp.net                      Fax: (214) 672-7275
  2499.  
  2500.  
  2501.   Harrie Hazewinkel
  2502.   Centre for Earth Observation
  2503.   Institute for Space Applications
  2504.   Joint Research Centre of the E.C.
  2505.   TP. 950
  2506.   Ispra 21020 (VA) Italy              Tel: +39+(0)332+789384
  2507.   harrie.hazewinkel@jrc.it            Fax: +39+(0)332+785500
  2508.  
  2509.  
  2510.   Juergen Schoenwaelder
  2511.   Computer Science Department
  2512.   University of Twente
  2513.   P.O. Box 217, NL-7500 AE Enschede
  2514.   The Netherlands.                    Tel: +31-53-489-3678
  2515.   schoenw@cs.utwente.nl               Fax: +31-53-489-3247
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552. Expires June 1, 1997                                      [Page 44]
  2553.  
  2554. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2555. Table of Contents
  2556.  
  2557.   1. Abstract..........2
  2558.   2. The SNMPv2 Network Management Framework..........2
  2559.   2.1. Object Definitions..........2
  2560.   3. Notation..........3
  2561.   4. A Note on Terminology..........3
  2562.   5. Introduction..........4
  2563.   6. WWW Entities..........4
  2564.   6.1. WWW Server..........5
  2565.   6.2. WWW Client..........5
  2566.   6.3. WWW Proxy..........5
  2567.   6.4. WWW Cached Proxy..........6
  2568.   7. HTTP Message..........6
  2569.   8. Relationship to other Standards Efforts..........6
  2570.   8.1. Relationship to NSM..........7
  2571.   8.2. Relationship to sysAppl and applMib..........7
  2572.   8.3. Document relation to sysApplInstall..........7
  2573.   8.4. Usage example for NSM to sysApplMIB relationship..........7
  2574.   9. Structure of the MIB..........8
  2575.   9.1. The systems group..........9
  2576.   9.2. The Statistics group..........9
  2577.   9.2.1. SummaryTable..........9
  2578.   9.2.2. RequestTable..........9
  2579.   9.2.3. ResponseTable..........9
  2580.   9.3. The Document group..........10
  2581.   9.3.1. wwwDocNameTable..........10
  2582.   9.3.2. wwwDocTable..........10
  2583.   9.3.3. wwwDocFilterTable..........10
  2584.   9.4. The Error group..........10
  2585.   9.5. The Application group..........10
  2586.   9.6. The Relation group..........10
  2587.   10. Definitions..........10
  2588.   11. Verification..........39
  2589.   11.1. SMICng Include File..........39
  2590.   12. References..........39
  2591.   13. Acknowledgments..........40
  2592.   14. Security Considerations..........40
  2593.   15. Appendix - Applicability to other services..........40
  2594.   15.1. FTP..........40
  2595.   15.2. NNTP..........41
  2596.   15.3. GOPHER..........41
  2597.   15.4. WAIS..........42
  2598.   15.5. Archie..........42
  2599.   16. Appendix - Todo List..........42
  2600.   16.1. Resolve wwwDocName usage and TC definition..........42
  2601.   16.2. Terminology..........42
  2602.   16.3. Handle illegal index values..........42
  2603.   16.4. Handle NSM to sysApplMIB relationship..........42
  2604.   16.5. Handle applIndex..........43
  2605.   16.6. Identify attributes for sysAppl framework..........43
  2606.   16.7. Regular Expression..........43
  2607.   16.8. Proxy Entity..........43
  2608.   16.9. Proxy Documents..........43
  2609.   16.10. Handle all [##...##]..........43
  2610.   17. Authors' Address..........43
  2611.  
  2612. INTERNET DRAFT                 WWW MIB                December 1, 1996
  2613.  
  2614. Expires June 1, 1997                                      [Page 46]
  2615.