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-04.txt < prev    next >
Text File  |  1997-08-01  |  72KB  |  2,224 lines
  1. Internet-Draft               WWW Service MIB                   July 1997
  2.  
  3.  
  4.             Definitions of Managed Objects for WWW Services
  5.  
  6.                              July 30, 1997
  7.  
  8.                    <draft-ietf-applmib-wwwmib-04.txt>
  9.  
  10.                            Harrie Hazewinkel
  11.                    Joint Research Centre of the E.C.
  12.                         harrie.hazewinkel@jrc.it
  13.  
  14.                           Carl W. Kalbfleisch
  15.                               Verio, Inc.
  16.                              cwk@verio.net
  17.  
  18.                          Juergen Schoenwaelder
  19.                           University of Twente
  20.                          schoenw@cs.utwente.nl
  21.  
  22.  
  23.  
  24.  
  25.  
  26. Status of this Memo
  27.  
  28.    This document is an Internet-Draft.  Internet-Drafts are working
  29.    documents of the Internet Engineering Task Force (IETF), its areas,
  30.    and its working groups.  Note that other groups may also distribute
  31.    working documents as Internet-Drafts.
  32.  
  33.    Internet-Drafts are draft documents valid for a maximum of six months
  34.    and may be updated, replaced, or obsoleted by other documents at any
  35.    time.  It is inappropriate to use Internet- Drafts as reference
  36.    material or to cite them other than as ``work in progress.''
  37.  
  38.    To learn the current status of any Internet-Draft, please check the
  39.    ``1id-abstracts.txt'' listing contained in the Internet- Drafts
  40.    Shadow Directories on ftp.is.co.za (Africa), nic.nordu.net (Europe),
  41.    munnari.oz.au (Pacific Rim), ds.internic.net (US East Coast), or
  42.    ftp.isi.edu (US West Coast).
  43.  
  44.    Distribution of this document is unlimited. Please send comments to
  45.    the Application MIB Working Group, <applmib@emi-summit.com>.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56. Expires December 1997                                           [Page 1]
  57.  
  58. Internet-Draft               WWW Service MIB                   July 1997
  59.  
  60.  
  61. 1.  Abstract
  62.  
  63.    This memo defines an experimental portion of the Management
  64.    Information Base (MIB) for use with network management protocols in
  65.    the Internet Community. In particular it describes a set of objects
  66.    for managing World-Wide Web (WWW) services. This MIB extends the
  67.    application management framework defined by the System Application
  68.    Management MIB (SYSAPPL-MIB) [9] and the Application Management MIB
  69.    (APPL-MIB) [10]. The WWW service statistics are based on an abstract
  70.    document transfer protocol (DTP). This abstract protocol can be
  71.    mapped on protocols like HTTP or FTP. Additional mappings may be
  72.    defined in the future in order to use this MIB with other document
  73.    transfer protocols. It is anticipated that such future mappings will
  74.    be defined in separate RFCs.
  75.  
  76.  
  77. 2.  The SNMPv2 Network Management Framework
  78.  
  79.    The SNMP Network Management Framework presently consists of three
  80.    major components. They are:
  81.  
  82.    o    the SMI, described in RFC 1902 [1] - the mechanisms used for
  83.         describing and naming objects for the purpose of management.
  84.  
  85.    o    the MIB-II, STD 17, RFC 1213 [2] - the core set of managed
  86.         objects for the Internet suite of protocols.
  87.  
  88.    o    the protocol, RFC 1157 [3] and/or RFC 1905 [4], - the protocol
  89.         for accessing managed objects.
  90.  
  91.    The Framework permits new objects to be defined for the purpose of
  92.    experimentation and evaluation.
  93.  
  94.  
  95.  
  96. 2.1.  Object Definitions
  97.  
  98.    Managed objects are accessed via a virtual information store, termed
  99.    the Management Information Base or MIB. Objects in the MIB are
  100.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  101.    defined in the SMI [1]. In particular, each object type is named by
  102.    an OBJECT IDENTIFIER, an administratively assigned name. The object
  103.    type together with an object instance serves to uniquely identify a
  104.    specific instantiation of the object. For human convenience, we often
  105.    use a textual string, termed the object descriptor, to refer to the
  106.    object type.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113. Expires December 1997                                           [Page 2]
  114.  
  115. Internet-Draft               WWW Service MIB                   July 1997
  116.  
  117.  
  118. 3.  Terminology
  119.  
  120.    This section defines the terminology used throughout this document.
  121.  
  122.    o    The 'World-Wide Web' (WWW) is a world wide information system
  123.         which is based on the concept of documents that are linked
  124.         together by embedding references (links) to other local or
  125.         remote documents.
  126.  
  127.    o    A 'document' is a coherent piece of data which is accessible in
  128.         the World-Wide Web. No assumptions are made about the content or
  129.         the type of a document.
  130.  
  131.    o    A 'Uniform Resource Locator' (URL) is a formatted string
  132.         representation for a document available via the Internet. URLs
  133.         are used to express references between documents. For the syntax
  134.         and semantics of the URL string representation is referred to
  135.         RFC 1630 [6] and RFC 1738 [5]
  136.  
  137.    o    A 'Document Transfer Protocol' (DTP) is a protocol used within
  138.         the World-Wide Web to transfer documents. The DTP is an
  139.         abstraction from real protocols, such as HTTP [12] or FTP [13].
  140.  
  141.    o    A 'request' is a DTP protocol operation which is targeted to a
  142.         'document' and invokes an action on the target document.  The
  143.         request type specifies the action that should be performed. A
  144.         request can have a document associated to it.
  145.  
  146.    o    A 'response' is a DTP protocol operation which is returned as a
  147.         result of a previous (and associated) request. The response
  148.         status indicates if the requested action was successful or if
  149.         errors occurred. A response can have a document associated to
  150.         it.
  151.  
  152.    o    An 'entity' is defined as a program which uses or provides a
  153.         World-Wide Web service realized through a document transfer
  154.         protocol. Entities can be further subdivided into client,
  155.         server, proxy and caching proxy entities.
  156.  
  157.    o    A 'client' is an entity which establishes connections for the
  158.         purpose of sending requests and receiving responses.
  159.  
  160.    o    A 'server' is an entity that accepts connections in order to
  161.         service requests by sending back responses.
  162.  
  163.    o    A 'proxy' is an intermediary entity which acts as both a server
  164.         and a client for the purpose of making requests on behalf of
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Expires December 1997                                           [Page 3]
  171.  
  172. Internet-Draft               WWW Service MIB                   July 1997
  173.  
  174.  
  175.         other clients. Requests are serviced internally or by passing
  176.         them on, with possible translation, to other servers.
  177.  
  178.    o    A 'caching proxy' is a proxy with the capability of locally
  179.         storing responses to associated requests. A caching proxy can
  180.         respond to similar requests with a previously stored response.
  181.  
  182.  
  183. 4.  Overview
  184.  
  185.    The World-Wide Web (WWW) is a global network of information,
  186.    accessible via user friendly programs (so-called browser).
  187.    Information is stored in documents, which can have various formats,
  188.    including hyper-text and multi-media documents. Access to these
  189.    documents is provided by servers which are located all around the
  190.    world and are linked to each other via hyper-links embedded in
  191.    documents.
  192.  
  193.    The usability of the World-Wide Web depends largely on the
  194.    performance of the services realized by these servers. The services
  195.    are typically monitored through log files. This becomes a difficult
  196.    task when a single organization is responsible for a large number of
  197.    services. It is therefore desirable to treat WWW services as objects
  198.    that can be managed by using the Internet network management
  199.    framework.
  200.  
  201.  
  202. 4.1.  Purpose and Requirements
  203.  
  204.    The goal of this MIB is to define a standardized set of objects which
  205.    lead to integrated and improved performance and fault management in a
  206.    heterogenous environment of WWW services. This MIB focuses on the
  207.    service level view. It does not deal with the operational view, which
  208.    is covered by the system application and the application MIBs [9,10].
  209.  
  210.    The purpose of this document is to define a set of managed objects
  211.    that allow to monitor WWW services for short-term operational
  212.    purposes, such as problem detection and troubleshooting. No attempts
  213.    are made here to cover accounting or hit metering issues.
  214.  
  215.    The scope of the MIB is further limited by the requirement that an
  216.    implementation conforming to this MIB must be possible without
  217.    putting a huge CPU or memory burden on the WWW server implementation.
  218.  
  219.    In addition, this MIB does not cover WWW service configuration.
  220.    Server software has become an interesting market where competing
  221.    vendors constantly invent new features in order to shape their
  222.  
  223.  
  224.  
  225.  
  226.  
  227. Expires December 1997                                           [Page 4]
  228.  
  229. Internet-Draft               WWW Service MIB                   July 1997
  230.  
  231.  
  232.    products. It is therefore not possible to reach consensus on a common
  233.    way to configure WWW services.
  234.  
  235.  
  236. 4.2.  Relationship to other Standards Efforts
  237.  
  238.    The WWW service MIB fits into the application management architecture
  239.    defined in the system application management MIB [9]. The system
  240.    application MIB [9] and the application MIB [10] use a process
  241.    oriented model, where an application is viewed as a collection of
  242.    processes. The WWW service MIB described in this memo uses a service
  243.    oriented view, which looks at the services provided by a set of
  244.    processes.
  245.  
  246.    The relationship between the process oriented view and the service
  247.    oriented view is a many-to-many relationship, because one process can
  248.    implement multiple services and multiple services can be implemented
  249.    by a single set of processes. The application management MIB [9] is
  250.    expected to contain a generic mapping table, which maps back and
  251.    forth between both views.
  252.  
  253.  
  254. 4.3.  WWW Entities
  255.  
  256.    The MIB is organized around the concept of a WWW entity. A WWW entity
  257.    is either a clients, a server or a proxy. Clients send out requests
  258.    to request information from a server or proxy entity. Server entities
  259.    receive, process and respond to requests received from client
  260.    entities. A server has access to local documents, which can be
  261.    transfered to clients.
  262.  
  263.    A proxy is a special server, who acts as both a server and a client
  264.    for the purpose of making requests on behalf of other clients. A
  265.    proxy is able to translate between the client and the origin server.
  266.    A proxy might also interact with other information retrieval system,
  267.    like for example databases.
  268.  
  269.    The MIB defined in this memo distinguishes between outgoing and
  270.    incoming requests and responses. This allows to obtain statistics for
  271.    clients, servers and proxies with a single set of objects.
  272.  
  273.    A special proxy server is the caching proxy, which maintains a cache
  274.    of previously received documents in order to reduce the bandwidth
  275.    used by World-Wide Web clients. One interesting management
  276.    information is the percentage of requests that were served from the
  277.    cache of the caching proxy (hits/miss-ratio). This ratio is not
  278.    contained explicitly in this MIB. Instead, the ratio can be derived
  279.  
  280.  
  281.  
  282.  
  283.  
  284. Expires December 1997                                           [Page 5]
  285.  
  286. Internet-Draft               WWW Service MIB                   July 1997
  287.  
  288.  
  289.    from the objects that count incoming and outgoing requests and
  290.    responses.
  291.  
  292.  
  293. 4.4.  Document Transfer Protocol
  294.  
  295.    The MIB is based on the concept of an abstract document transfer
  296.    protocol (DTP). The purpose of the abstract document transfer
  297.    protocol is to make the MIB definitions independent from concrete
  298.    protocols, like the Hypertext Transfer Protocol (HTTP) [11,12] or the
  299.    File Transfer Protocol (FTP) [13].
  300.  
  301.    The document transfer protocol makes the following assumptions:
  302.  
  303.    -    The transfer protocol uses a request/response style of
  304.         interactions.
  305.  
  306.    -    The request contains a request type, which defines the
  307.         operations performed by the receiving server. The request type
  308.         is represented by an OCTET STRING. It might be necessary to
  309.         define a translation into an OCTET STRING value for protocols
  310.         that use numbers to identify request types.
  311.  
  312.    -    The response contains a status code, which indicates if the
  313.         request was processed successfully or which error occured. The
  314.         status code is represented as an INTEGER value. It might be
  315.         necessary to define a mapping for protocols that do not use an
  316.         INTEGER status code.
  317.  
  318.    -    The MIB defined in this memo makes the assumption that every
  319.         response can be related to a particular request. Some protocols
  320.         allow to send multiple responses to a single request. This case
  321.         can be handled by defining which responses is the "primary"
  322.         response to a request.
  323.  
  324.    The appendix of this memo defines a mapping of the document transfer
  325.    protocol on the HTTP protocol and the FTP protocol. Mappings to other
  326.    protocols, like NNTP [RFC 0977] or WebNFS [RFC 2054, RFC 2055] might
  327.    be defined in the future.
  328.  
  329.  
  330. 5.  Structure of the MIB
  331.  
  332.    This section presents the structure of the MIB. The objects are
  333.    arranged into the following groups:
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341. Expires December 1997                                           [Page 6]
  342.  
  343. Internet-Draft               WWW Service MIB                   July 1997
  344.  
  345.  
  346.    o    entity information
  347.  
  348.    o    service statistics
  349.  
  350.    o    document statistics
  351.  
  352.  
  353. 5.1.  Entity Group
  354.  
  355.    The entity group consists of a single table describing all the
  356.    entities managed by the SNMP agent. The entity table contains not
  357.    only basic network management information for (potentially) multiple
  358.    entities running on a single host, but also information for all
  359.    entities within virtual domains of the host. The columnar objects in
  360.    the table can be divided into two main groups:
  361.  
  362.    1.   global administrative information of the entity, such as entity
  363.         contact person, and
  364.  
  365.    2.   network information, such as the transfer protocol.
  366.  
  367.  
  368. 5.2.  Service Statistics Group
  369.  
  370.    The service statistics group provides network management information
  371.    about the traffic received or transmitted by an entity. This group
  372.    contains all network traffic related counters and consists of five
  373.    tables:
  374.  
  375.    o    The wwwSummaryTable contains a set of network traffic related
  376.         counters. The table provides a summarization of the network
  377.         traffic which is also found in the request and response tables.
  378.         It is well recognized that certain variables are redundant with
  379.         respect to the request and response tables, but they are added
  380.         to provide an operator a quick overview and to reduce SNMP
  381.         network traffic.
  382.  
  383.    o    The wwwRequestInTable contains detailed information about
  384.         incoming requests. Every particular request type is counted
  385.         separately.
  386.  
  387.    o    The wwwRequestOutTable contains detailed information about
  388.         outgoing requests. Every particular request type is counted
  389.         separately.
  390.  
  391.    o    The wwwResponseInTable contains detailed information about
  392.         incoming responses. Every particular response type is counted
  393.  
  394.  
  395.  
  396.  
  397.  
  398. Expires December 1997                                           [Page 7]
  399.  
  400. Internet-Draft               WWW Service MIB                   July 1997
  401.  
  402.  
  403.         separately.
  404.  
  405.    o    The wwwResponseOutTable contains detailed information about
  406.         outgoing responses. Every particular response type is counted
  407.         separately.
  408.  
  409.  
  410. 5.3.  Document Statistics Group
  411.  
  412.    The document group contains information about the documents which
  413.    were accessed in the past. The group consist of the following tables:
  414.  
  415.    o    The wwwDocCtrlTable provides the manager a means to control and
  416.         configure which statistics are collected and when statistics
  417.         will expire.
  418.  
  419.    o    The wwwDocLastNTable provides the manager information about the
  420.         last N documents which where accessed. The table lists the
  421.         document attempted to read together with the request and
  422.         response type of the DTP an a status message. The request and
  423.         response types provide a manager information of how read
  424.         attempts were handled by the DTP. The status message provides
  425.         the manager information how read attempts has been handled by
  426.         the implementation of the WWW entity. The number of documents in
  427.         the wwwDocLastNTable is controlled by the wwwDocCtrlLastNSize
  428.         object in the wwwDocCtrlTable. The wwwDocCtrlLastNStatus object
  429.         of the wwwDocCtrlTable allows to disable table updates so that a
  430.         manager can read fast changing tables.
  431.  
  432.    o    The wwwDocBucketTable lists the buckets of statistical
  433.         information that have been collected for a WWW entity. An entry
  434.         in the wwwDocBucketTable contains administrative information
  435.         about the bucket (the creation timestamp or the sort order) as
  436.         well as summary information (number of accesses, number of
  437.         document and number of bytes transferred).
  438.  
  439.    o    The wwwDocBucketTopNTable provides the manager an overview of
  440.         the top N documents which were accessed. The size N of a bucket
  441.         is controlled by the wwwDocCtrlBucketSize object in the
  442.         wwwDocCtrlTable.  A new bucket is created after a certain time
  443.         interval has passed.  The time interval is controlled by the
  444.         wwwDocCtrlBucketTimeInterval object of the wwwDocCtrlTable. The
  445.         maximum number of buckets maintained by the SNMP agent is
  446.         controlled by the wwwDocCtrlBuckets object of the
  447.         wwwDocCtrlTable. A bucket can be sorted according to the number
  448.         of accesses or the number of bytes transferred. The sort order
  449.         is controlled by wwwDocCtrlBucketSort object of the
  450.  
  451.  
  452.  
  453.  
  454.  
  455. Expires December 1997                                           [Page 8]
  456.  
  457. Internet-Draft               WWW Service MIB                   July 1997
  458.  
  459.  
  460.         wwwDocCtrlTable.
  461.  
  462.  
  463. 6.  Definitions
  464.  
  465.    WWW-MIB DEFINITIONS ::= BEGIN
  466.  
  467.    IMPORTS
  468.        mib-2,
  469.        MODULE-IDENTITY,
  470.        OBJECT-TYPE,
  471.        Counter32,
  472.        Integer32,
  473.        Unsigned32
  474.            FROM SNMPv2-SMI
  475.  
  476.        TEXTUAL-CONVENTION,
  477.        DisplayString,
  478.        TimeStamp,
  479.        DateAndTime,
  480.        TimeInterval
  481.            FROM SNMPv2-TC
  482.  
  483.        MODULE-COMPLIANCE,
  484.        OBJECT-GROUP
  485.            FROM SNMPv2-CONF;
  486.  
  487.    wwwMIB MODULE-IDENTITY
  488.        LAST-UPDATED "9703300000Z"
  489.        ORGANIZATION "Application MIB Working Group"
  490.        CONTACT-INFO
  491.            "        Harrie Hazewinkel
  492.  
  493.             Postal: MUSIQ/DESIRE/CEO Program
  494.                     Centre for Earth Observation
  495.                     Institute for Space Applications
  496.                     Joint Research Centre of the E.C.
  497.                     TP. 950
  498.                     Ispra 21020 (VA) Italy
  499.  
  500.                Tel: +39+(0)332+789384
  501.                Fax: +39+(0)332+785500
  502.             E-mail: harrie.hazewinkel@jrc.it
  503.  
  504.                     Carl W. Kalbfleisch
  505.  
  506.             Postal: Verio, Inc.
  507.  
  508.  
  509.  
  510.  
  511.  
  512. Expires December 1997                                           [Page 9]
  513.  
  514. Internet-Draft               WWW Service MIB                   July 1997
  515.  
  516.  
  517.                     1950 Stemmons Freeway
  518.                     Suite 2004 - Infomart
  519.                     Dallas, TX 75207
  520.                     US
  521.  
  522.                Tel: +1 972 238-8303
  523.                Fax: +1 972 238-0268
  524.             E-mail: cwk@verio.net
  525.  
  526.                     Juergen Schoenwaelder
  527.  
  528.             Postal: Computer Science Department
  529.                     University of Twente
  530.                     P.O. Box 217, NL-7500 AE Enschede
  531.                     The Netherlands.
  532.  
  533.                Tel: +31 53 489-3678
  534.                Fax: +31 53 489-3247
  535.             E-mail: schoenw@cs.utwente.nl"
  536.        DESCRIPTION
  537.            "The MIB module for WWW entities. The MIB is applicable to
  538.             a wide family of 'Document Transfer Protocols' (DTP).
  539.             Examples are HTTP and FTP."
  540.  
  541.        REVISION "9707300000Z"
  542.        DESCRIPTION
  543.            "The initial revision."
  544.  
  545.        ::= { mib-2 8080 } -- TBD
  546.  
  547.    --
  548.    --  Object Identifier Assignments
  549.    --
  550.  
  551.    wwwMIBObjects     OBJECT IDENTIFIER ::= { wwwMIB 1 }
  552.    wwwMIBConformance OBJECT IDENTIFIER ::= { wwwMIB 2 }
  553.    wwwMIBCompliances OBJECT IDENTIFIER ::= { wwwMIBConformance 1 }
  554.    wwwMIBGroups      OBJECT IDENTIFIER ::= { wwwMIBConformance 2 }
  555.  
  556.    --
  557.    -- Textual Conventions
  558.    --
  559.  
  560.    WwwRequestType ::= TEXTUAL-CONVENTION
  561.        STATUS      current
  562.        DESCRIPTION
  563.            "The WwwRequestType describes the types of requests.
  564.  
  565.  
  566.  
  567.  
  568.  
  569. Expires December 1997                                          [Page 10]
  570.  
  571. Internet-Draft               WWW Service MIB                   July 1997
  572.  
  573.  
  574.             The value of this type is the same textual
  575.             identification of request types used by a document
  576.             transfer protocol.
  577.  
  578.             For the proper values is referred to the specific
  579.             protocol mapping."
  580.        SYNTAX      OCTET STRING (SIZE (1..40))
  581.  
  582.  
  583.    WwwResponseType ::= TEXTUAL-CONVENTION
  584.        STATUS      current
  585.        DESCRIPTION
  586.            "The WwwResponseType defines the different response
  587.             values used by document transfer protocols.
  588.  
  589.             For the proper values is referred to the specific
  590.             protocol mapping."
  591.        SYNTAX      Integer32 (0..2147483647)
  592.  
  593.    WwwEntityType ::= TEXTUAL-CONVENTION
  594.        STATUS      current
  595.        DESCRIPTION
  596.            "The type of the wwwEntity."
  597.        SYNTAX      INTEGER {
  598.                        wwwEntityTypeServer(1),
  599.                        wwwEntityTypeClient(2),
  600.                        wwwEntityTypeProxy(3),
  601.                        wwwEntityTypeCachingProxy(4),
  602.                        wwwEntityTypeOther(5)
  603.                    }
  604.  
  605.    WwwEntityOperStatus ::= TEXTUAL-CONVENTION
  606.        STATUS      current
  607.        DESCRIPTION
  608.            "The operational status of the wwwEntity. 'down'
  609.             indicates that the wwwEntity is not available.
  610.             'running' indicates that the wwwEntity is operational
  611.             and available. 'halted' indicates that the wwwEntity
  612.             is operational but not available.  'congested'
  613.             indicates that the wwwEntity is operational but no
  614.             additional inbound associations can be accommodated.
  615.             'restarting' indicates that the wwwEntity is currently
  616.             unavailable but is in the process of restarting and
  617.             will be available soon."
  618.        SYNTAX      INTEGER {
  619.                        down(1),
  620.                        running(2),
  621.  
  622.  
  623.  
  624.  
  625.  
  626. Expires December 1997                                          [Page 11]
  627.  
  628. Internet-Draft               WWW Service MIB                   July 1997
  629.  
  630.  
  631.                        halted(3),
  632.                        congested(4),
  633.                        restarting(5)
  634.                    }
  635.  
  636.    WwwDocName ::= TEXTUAL-CONVENTION
  637.        STATUS      current
  638.        DESCRIPTION
  639.            "The server relative name of a document. If the URL were
  640.             http://www.x.org/standards/search/search.cgi?string=test
  641.             then the value of this textual convention would resolve
  642.             to '/standards/search/search.cgi'."
  643.        SYNTAX      DisplayString
  644.  
  645.    WwwDocSort ::= TEXTUAL-CONVENTION
  646.        STATUS      current
  647.        DESCRIPTION
  648.            "A data type defining the sort order of document statistics.
  649.  
  650.             The value 'accesses' means that every new created bucket
  651.             is sorted in descending order according to the number of
  652.             document access attempts.
  653.  
  654.             The value 'bytes' means that every new created bucket
  655.             is sorted in descending order according to the number of
  656.             bytes transfered in response to document accesses."
  657.        SYNTAX      INTEGER { accesses(1), bytes(2) }
  658.  
  659.  
  660.    -- The WWW Entity Group
  661.    --
  662.    -- The WWW entity group contains information about the WWW entities
  663.    -- known by the SNMP protocol entity.
  664.  
  665.    wwwEntity OBJECT IDENTIFIER ::= { wwwMIBObjects 1 }
  666.  
  667.    wwwEntityTable OBJECT-TYPE
  668.        SYNTAX      SEQUENCE OF WwwEntityEntry
  669.        MAX-ACCESS  not-accessible
  670.        STATUS      current
  671.        DESCRIPTION
  672.            "The table of the entities present on the system."
  673.        ::= { wwwEntity 1 }
  674.  
  675.    wwwEntityEntry OBJECT-TYPE
  676.        SYNTAX      WwwEntityEntry
  677.        MAX-ACCESS  not-accessible
  678.  
  679.  
  680.  
  681.  
  682.  
  683. Expires December 1997                                          [Page 12]
  684.  
  685. Internet-Draft               WWW Service MIB                   July 1997
  686.  
  687.  
  688.        STATUS      current
  689.        DESCRIPTION
  690.            "Details of a particular entity which can be a
  691.             server, a client, a proxy or a caching-proxy."
  692.        INDEX       { wwwEntityIndex }
  693.        ::= { wwwEntityTable 1 }
  694.  
  695.    WwwEntityEntry ::= SEQUENCE {
  696.        wwwEntityIndex              Unsigned32,
  697.        wwwEntityDescription        DisplayString,
  698.        wwwEntityContact            DisplayString,
  699.        wwwEntityProtocol           OBJECT IDENTIFIER,
  700.        wwwEntityName               DisplayString,
  701.        wwwEntityType               WwwEntityType,
  702.        wwwEntityUptime             TimeStamp,
  703.        wwwEntityOperStatus         WwwEntityOperStatus,
  704.        wwwEntityLastChange         TimeStamp
  705.    }
  706.  
  707.    wwwEntityIndex OBJECT-TYPE
  708.        SYNTAX      Unsigned32 (1..'ffffffff'h)
  709.        MAX-ACCESS  not-accessible
  710.        STATUS      current
  711.        DESCRIPTION
  712.            "An integer used for indexing purposes. Generally
  713.             monotonically increasing from 1 as new entities
  714.             are initialized.
  715.  
  716.             The value for each entity must remain constant
  717.             from one re-initialization of the network management
  718.             agent to the next re-initialization."
  719.        ::= { wwwEntityEntry 1 }
  720.  
  721.    wwwEntityDescription OBJECT-TYPE
  722.        SYNTAX      DisplayString
  723.        MAX-ACCESS  read-only
  724.        STATUS      current
  725.        DESCRIPTION
  726.            "Textual description of the entity.  This shall include
  727.             at least the vendor and version number of the application.
  728.             In a minimal case, this might be the Product Token (see RFC
  729.             2086) for the application."
  730.        ::= { wwwEntityEntry 2 }
  731.  
  732.    wwwEntityContact OBJECT-TYPE
  733.        SYNTAX      DisplayString
  734.        MAX-ACCESS  read-only
  735.  
  736.  
  737.  
  738.  
  739.  
  740. Expires December 1997                                          [Page 13]
  741.  
  742. Internet-Draft               WWW Service MIB                   July 1997
  743.  
  744.  
  745.        STATUS      current
  746.        DESCRIPTION
  747.            "The textual identification of the contact person
  748.             for this entity, together with information on how
  749.             to contact this person.  For instance, this might
  750.             be 'webmaster@domain.name'."
  751.        ::= { wwwEntityEntry 3 }
  752.  
  753.    wwwEntityProtocol OBJECT-TYPE
  754.        SYNTAX      OBJECT IDENTIFIER
  755.        MAX-ACCESS  read-only
  756.        STATUS      current
  757.        DESCRIPTION
  758.            "An identification of the primary protocol in use by this
  759.             entity. For Internet applications, the IANA maintains
  760.             a registry of the OIDs which correspond to well-known
  761.             applications.  If the application protocol is not listed
  762.             in the registry, an OID value of the form {applTCPProtoID
  763.             port} or {applUDProtoID port} are used for TCP-based and
  764.             UDP-based protocols, respectively. In either case 'port'
  765.             corresponds to the primary port number being used by the
  766.             protocol."
  767.        ::= { wwwEntityEntry 4 }
  768.  
  769.    wwwEntityName OBJECT-TYPE
  770.        SYNTAX      DisplayString
  771.        MAX-ACCESS  read-only
  772.        STATUS      current
  773.        DESCRIPTION
  774.            "The fully qualified domain name by which this entity is
  775.             known.  This may be different than applName since that
  776.             value is only a textual name for the application."
  777.        ::= { wwwEntityEntry 5 }
  778.  
  779.    wwwEntityType OBJECT-TYPE
  780.        SYNTAX      WwwEntityType
  781.        MAX-ACCESS  read-only
  782.        STATUS      current
  783.        DESCRIPTION
  784.            "Identification of the role of the entity."
  785.        ::= { wwwEntityEntry 6 }
  786.  
  787.    wwwEntityUptime OBJECT-TYPE
  788.        SYNTAX      TimeStamp
  789.        MAX-ACCESS  read-only
  790.        STATUS      current
  791.        DESCRIPTION
  792.  
  793.  
  794.  
  795.  
  796.  
  797. Expires December 1997                                          [Page 14]
  798.  
  799. Internet-Draft               WWW Service MIB                   July 1997
  800.  
  801.  
  802.            "The value of sysUpTime at the time the wwwEntity
  803.             was last initialized.  If the application was
  804.             last initialized prior to the last initialization of the
  805.             network management subsystem, then this object contains
  806.             a zero value."
  807.        ::= { wwwEntityEntry 7 }
  808.  
  809.    wwwEntityOperStatus OBJECT-TYPE
  810.        SYNTAX      WwwEntityOperStatus
  811.        MAX-ACCESS  read-only
  812.        STATUS      current
  813.        DESCRIPTION
  814.            "Indicates the operational status of the wwwEntity."
  815.        ::= { wwwEntityEntry 8 }
  816.  
  817.    wwwEntityLastChange OBJECT-TYPE
  818.        SYNTAX      TimeStamp
  819.        MAX-ACCESS  read-only
  820.        STATUS      current
  821.        DESCRIPTION
  822.            "The value of sysUpTime at the time the wwwEntity
  823.             entered its current operational state.  If
  824.             the current state was entered prior to the last
  825.             initialization of the local network management subsystem,
  826.             then this object contains a zero value."
  827.        ::= { wwwEntityEntry 9 }
  828.  
  829.  
  830.    -- The WWW Service Statistics Group
  831.    --
  832.    -- The WWW statistics group contains information concerning the
  833.    -- requests and responses send or received by WWW entities.
  834.  
  835.    wwwServiceStatistics OBJECT IDENTIFIER ::= { wwwMIBObjects 2 }
  836.  
  837.    wwwSummaryTable OBJECT-TYPE
  838.        SYNTAX      SEQUENCE OF WwwSummaryEntry
  839.        MAX-ACCESS  not-accessible
  840.        STATUS      current
  841.        DESCRIPTION
  842.            "The table providing overview statistics for the
  843.             entities on this system."
  844.        ::= { wwwServiceStatistics 1 }
  845.  
  846.    wwwSummaryEntry OBJECT-TYPE
  847.        SYNTAX      WwwSummaryEntry
  848.        MAX-ACCESS  not-accessible
  849.  
  850.  
  851.  
  852.  
  853.  
  854. Expires December 1997                                          [Page 15]
  855.  
  856. Internet-Draft               WWW Service MIB                   July 1997
  857.  
  858.  
  859.        STATUS      current
  860.        DESCRIPTION
  861.            "Overview statistics for an individual entity."
  862.        INDEX       { wwwEntityIndex }
  863.        ::= { wwwSummaryTable 1 }
  864.  
  865.    WwwSummaryEntry ::= SEQUENCE {
  866.        wwwSummaryInRequests        Counter32,
  867.        wwwSummaryOutRequests       Counter32,
  868.        wwwSummaryInResponses       Counter32,
  869.        wwwSummaryOutResponses      Counter32,
  870.        wwwSummaryInBytes           Counter32,
  871.        wwwSummaryOutBytes          Counter32
  872.    }
  873.  
  874.    wwwSummaryInRequests OBJECT-TYPE
  875.        SYNTAX      Counter32
  876.        MAX-ACCESS  read-only
  877.        STATUS      current
  878.        DESCRIPTION
  879.            "The number of requests successfully received by and processed
  880.             by this entity."
  881.        ::= { wwwSummaryEntry 1 }
  882.  
  883.    wwwSummaryOutRequests OBJECT-TYPE
  884.        SYNTAX      Counter32
  885.        MAX-ACCESS  read-only
  886.        STATUS      current
  887.        DESCRIPTION
  888.            "The number of requests generated by this entity."
  889.        ::= { wwwSummaryEntry 2 }
  890.  
  891.    wwwSummaryInResponses OBJECT-TYPE
  892.        SYNTAX      Counter32
  893.        MAX-ACCESS  read-only
  894.        STATUS      current
  895.        DESCRIPTION
  896.            "The number of responses successfully received and processed
  897.             by this entity."
  898.        ::= { wwwSummaryEntry 3 }
  899.  
  900.    wwwSummaryOutResponses OBJECT-TYPE
  901.        SYNTAX      Counter32
  902.        MAX-ACCESS  read-only
  903.        STATUS      current
  904.        DESCRIPTION
  905.            "The number of responses generated by this entity."
  906.  
  907.  
  908.  
  909.  
  910.  
  911. Expires December 1997                                          [Page 16]
  912.  
  913. Internet-Draft               WWW Service MIB                   July 1997
  914.  
  915.  
  916.        ::= { wwwSummaryEntry 4 }
  917.  
  918.    wwwSummaryInBytes OBJECT-TYPE
  919.        SYNTAX      Counter32
  920.        MAX-ACCESS  read-only
  921.        STATUS      current
  922.        DESCRIPTION
  923.            "The number of content bytes received by this entity."
  924.        ::= { wwwSummaryEntry 5 }
  925.  
  926.    wwwSummaryOutBytes OBJECT-TYPE
  927.        SYNTAX      Counter32
  928.        MAX-ACCESS  read-only
  929.        STATUS      current
  930.        DESCRIPTION
  931.            "The number of content bytes generated by this entity."
  932.        ::= { wwwSummaryEntry 6 }
  933.  
  934.    -- The WWW request tables contain detailed information about
  935.    -- requests send or received by WWW entities.
  936.  
  937.    wwwRequestInTable OBJECT-TYPE
  938.        SYNTAX      SEQUENCE OF WwwRequestInEntry
  939.        MAX-ACCESS  not-accessible
  940.        STATUS      current
  941.        DESCRIPTION
  942.            "The table providing detailed statistics for
  943.             requests received by entities on this system."
  944.        ::= { wwwServiceStatistics 2 }
  945.  
  946.    wwwRequestInEntry OBJECT-TYPE
  947.        SYNTAX      WwwRequestInEntry
  948.        MAX-ACCESS  not-accessible
  949.        STATUS      current
  950.        DESCRIPTION
  951.            "Request statistics for an individual entity."
  952.        INDEX       { wwwEntityIndex, wwwRequestInIndex }
  953.        ::= { wwwRequestInTable 1 }
  954.  
  955.    WwwRequestInEntry ::= SEQUENCE {
  956.        wwwRequestInIndex           WwwRequestType,
  957.        wwwRequestInCount           Counter32,
  958.        wwwRequestInBytes           Counter32,
  959.        wwwRequestInLastTime        TimeStamp
  960.    }
  961.  
  962.    wwwRequestInIndex OBJECT-TYPE
  963.  
  964.  
  965.  
  966.  
  967.  
  968. Expires December 1997                                          [Page 17]
  969.  
  970. Internet-Draft               WWW Service MIB                   July 1997
  971.  
  972.  
  973.        SYNTAX      WwwRequestType
  974.        MAX-ACCESS  not-accessible
  975.        STATUS      current
  976.        DESCRIPTION
  977.            "The particular request type the statistics apply to."
  978.        ::= { wwwRequestInEntry 1 }
  979.  
  980.    wwwRequestInCount OBJECT-TYPE
  981.        SYNTAX      Counter32
  982.        MAX-ACCESS  read-only
  983.        STATUS      current
  984.        DESCRIPTION
  985.            "The number of requests of this type received by
  986.             this entity."
  987.        ::= { wwwRequestInEntry 2 }
  988.  
  989.    wwwRequestInBytes OBJECT-TYPE
  990.        SYNTAX      Counter32
  991.        MAX-ACCESS  read-only
  992.        STATUS      current
  993.        DESCRIPTION
  994.            "The number of content bytes per request type
  995.             received by this entity."
  996.        ::= { wwwRequestInEntry 3 }
  997.  
  998.    wwwRequestInLastTime OBJECT-TYPE
  999.        SYNTAX      TimeStamp
  1000.        MAX-ACCESS  read-only
  1001.        STATUS      current
  1002.        DESCRIPTION
  1003.            "The value of sysUpTime when the last byte of the last
  1004.             complete request of this type was received by this
  1005.             entity."
  1006.        ::= { wwwRequestInEntry 4 }
  1007.  
  1008.    wwwRequestOutTable OBJECT-TYPE
  1009.        SYNTAX      SEQUENCE OF WwwRequestOutEntry
  1010.        MAX-ACCESS  not-accessible
  1011.        STATUS      current
  1012.        DESCRIPTION
  1013.            "The table providing detailed statistics for
  1014.             requests generated bt the entities on this system."
  1015.        ::= { wwwServiceStatistics 3 }
  1016.  
  1017.    wwwRequestOutEntry OBJECT-TYPE
  1018.        SYNTAX      WwwRequestOutEntry
  1019.        MAX-ACCESS  not-accessible
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025. Expires December 1997                                          [Page 18]
  1026.  
  1027. Internet-Draft               WWW Service MIB                   July 1997
  1028.  
  1029.  
  1030.        STATUS      current
  1031.        DESCRIPTION
  1032.            "Request statistics for an individual entity."
  1033.        INDEX       { wwwEntityIndex, wwwRequestOutIndex }
  1034.        ::= { wwwRequestOutTable 1 }
  1035.  
  1036.    WwwRequestOutEntry ::= SEQUENCE {
  1037.        wwwRequestOutIndex          WwwRequestType,
  1038.        wwwRequestOutCount          Counter32,
  1039.        wwwRequestOutBytes          Counter32,
  1040.        wwwRequestOutLastTime       TimeStamp
  1041.    }
  1042.  
  1043.    wwwRequestOutIndex OBJECT-TYPE
  1044.        SYNTAX      WwwRequestType
  1045.        MAX-ACCESS  not-accessible
  1046.        STATUS      current
  1047.        DESCRIPTION
  1048.            "The particular request type the statistics apply to."
  1049.        ::= { wwwRequestOutEntry 1 }
  1050.  
  1051.    wwwRequestOutCount OBJECT-TYPE
  1052.        SYNTAX      Counter32
  1053.        MAX-ACCESS  read-only
  1054.        STATUS      current
  1055.        DESCRIPTION
  1056.            "The number of requests of this type generated by this
  1057.             entity."
  1058.        ::= { wwwRequestOutEntry 2 }
  1059.  
  1060.    wwwRequestOutBytes OBJECT-TYPE
  1061.        SYNTAX      Counter32
  1062.        MAX-ACCESS  read-only
  1063.        STATUS      current
  1064.        DESCRIPTION
  1065.            "The number of content bytes per response type
  1066.             generated by this entity."
  1067.        ::= { wwwRequestOutEntry 3 }
  1068.  
  1069.    wwwRequestOutLastTime OBJECT-TYPE
  1070.        SYNTAX      TimeStamp
  1071.        MAX-ACCESS  read-only
  1072.        STATUS      current
  1073.        DESCRIPTION
  1074.            "The value of sysUpTime when the first byte of the
  1075.             last request of this type was send by this entity."
  1076.        ::= { wwwRequestOutEntry 4 }
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082. Expires December 1997                                          [Page 19]
  1083.  
  1084. Internet-Draft               WWW Service MIB                   July 1997
  1085.  
  1086.  
  1087.    -- The WWW response tables contain detailed information about
  1088.    -- responses send or received by WWW entities.
  1089.  
  1090.    wwwResponseInTable OBJECT-TYPE
  1091.        SYNTAX      SEQUENCE OF WwwResponseInEntry
  1092.        MAX-ACCESS  not-accessible
  1093.        STATUS      current
  1094.        DESCRIPTION
  1095.            "The table providing detailed statistics for
  1096.             responses received by entities on this system."
  1097.        ::= { wwwServiceStatistics 4 }
  1098.  
  1099.    wwwResponseInEntry OBJECT-TYPE
  1100.        SYNTAX      WwwResponseInEntry
  1101.        MAX-ACCESS  not-accessible
  1102.        STATUS      current
  1103.        DESCRIPTION
  1104.            "Response statistics for an individual entity."
  1105.        INDEX       { wwwEntityIndex, wwwResponseInIndex }
  1106.        ::= { wwwResponseInTable 1 }
  1107.  
  1108.    WwwResponseInEntry ::= SEQUENCE {
  1109.        wwwResponseInIndex          WwwResponseType,
  1110.        wwwResponseInCount          Counter32,
  1111.        wwwResponseInBytes          Counter32,
  1112.        wwwResponseInLastTime       TimeStamp
  1113.    }
  1114.  
  1115.    wwwResponseInIndex OBJECT-TYPE
  1116.        SYNTAX      WwwResponseType
  1117.        MAX-ACCESS  not-accessible
  1118.        STATUS      current
  1119.        DESCRIPTION
  1120.            "The particular response type the statistics apply to."
  1121.        ::= { wwwResponseInEntry 1 }
  1122.  
  1123.    wwwResponseInCount OBJECT-TYPE
  1124.        SYNTAX      Counter32
  1125.        MAX-ACCESS  read-only
  1126.        STATUS      current
  1127.        DESCRIPTION
  1128.            "The number of responses of this type received by this
  1129.             entity."
  1130.        ::= { wwwResponseInEntry 2 }
  1131.  
  1132.    wwwResponseInBytes OBJECT-TYPE
  1133.        SYNTAX      Counter32
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139. Expires December 1997                                          [Page 20]
  1140.  
  1141. Internet-Draft               WWW Service MIB                   July 1997
  1142.  
  1143.  
  1144.        MAX-ACCESS  read-only
  1145.        STATUS      current
  1146.        DESCRIPTION
  1147.            "The number of content bytes per response type
  1148.             received by this entity."
  1149.        ::= { wwwResponseInEntry 3 }
  1150.  
  1151.    wwwResponseInLastTime OBJECT-TYPE
  1152.        SYNTAX      TimeStamp
  1153.        MAX-ACCESS  read-only
  1154.        STATUS      current
  1155.        DESCRIPTION
  1156.            "The value of sysUpTime when the last byte of the last
  1157.             complete response of this type was received by this
  1158.             entity."
  1159.        ::= { wwwResponseInEntry 4 }
  1160.  
  1161.    wwwResponseOutTable OBJECT-TYPE
  1162.        SYNTAX      SEQUENCE OF WwwResponseOutEntry
  1163.        MAX-ACCESS  not-accessible
  1164.        STATUS      current
  1165.        DESCRIPTION
  1166.            "The table providing detailed statistics for
  1167.             responses generated by entities on this system."
  1168.        ::= { wwwServiceStatistics 5 }
  1169.  
  1170.    wwwResponseOutEntry OBJECT-TYPE
  1171.        SYNTAX      WwwResponseOutEntry
  1172.        MAX-ACCESS  not-accessible
  1173.        STATUS      current
  1174.        DESCRIPTION
  1175.            "Response statistics for an individual entity."
  1176.        INDEX       { wwwEntityIndex, wwwResponseOutIndex }
  1177.        ::= { wwwResponseOutTable 1 }
  1178.  
  1179.    WwwResponseOutEntry ::= SEQUENCE {
  1180.        wwwResponseOutIndex         WwwResponseType,
  1181.        wwwResponseOutCount         Counter32,
  1182.        wwwResponseOutBytes         Counter32,
  1183.        wwwResponseOutLastTime      TimeStamp
  1184.    }
  1185.  
  1186.    wwwResponseOutIndex OBJECT-TYPE
  1187.        SYNTAX      WwwResponseType
  1188.        MAX-ACCESS  not-accessible
  1189.        STATUS      current
  1190.        DESCRIPTION
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196. Expires December 1997                                          [Page 21]
  1197.  
  1198. Internet-Draft               WWW Service MIB                   July 1997
  1199.  
  1200.  
  1201.            "The particular response type the statistics apply to."
  1202.        ::= { wwwResponseOutEntry 1 }
  1203.  
  1204.    wwwResponseOutCount OBJECT-TYPE
  1205.        SYNTAX      Counter32
  1206.        MAX-ACCESS  read-only
  1207.        STATUS      current
  1208.        DESCRIPTION
  1209.            "The number of responses of this type generated by this
  1210.             entity."
  1211.        ::= { wwwResponseOutEntry 2 }
  1212.  
  1213.    wwwResponseOutBytes OBJECT-TYPE
  1214.        SYNTAX      Counter32
  1215.        MAX-ACCESS  read-only
  1216.        STATUS      current
  1217.        DESCRIPTION
  1218.            "The number of content bytes per response type
  1219.             generated by this entity."
  1220.        ::= { wwwResponseOutEntry 3 }
  1221.  
  1222.    wwwResponseOutLastTime OBJECT-TYPE
  1223.        SYNTAX      TimeStamp
  1224.        MAX-ACCESS  read-only
  1225.        STATUS      current
  1226.        DESCRIPTION
  1227.            "The value of sysUpTime when the first byte of the
  1228.             last response of this type was sent by this entity."
  1229.        ::= { wwwResponseOutEntry 4 }
  1230.  
  1231.  
  1232.    -- The WWW Document Statistics Group
  1233.    --
  1234.    -- The WWW document statistics group contains statistics about
  1235.    -- document read attempts.
  1236.  
  1237.    wwwDocumentStatistics OBJECT IDENTIFIER ::= { wwwMIBObjects 3 }
  1238.  
  1239.    wwwDocCtrlTable OBJECT-TYPE
  1240.        SYNTAX      SEQUENCE OF WwwDocCtrlEntry
  1241.        MAX-ACCESS  not-accessible
  1242.        STATUS      current
  1243.        DESCRIPTION
  1244.            "A table which controls how the MIB implementation
  1245.             collects and maintains document statistics."
  1246.        ::= { wwwDocumentStatistics 1 }
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253. Expires December 1997                                          [Page 22]
  1254.  
  1255. Internet-Draft               WWW Service MIB                   July 1997
  1256.  
  1257.  
  1258.    wwwDocCtrlEntry OBJECT-TYPE
  1259.        SYNTAX      WwwDocCtrlEntry
  1260.        MAX-ACCESS  not-accessible
  1261.        STATUS      current
  1262.        DESCRIPTION
  1263.            "An entry which allows to configure the
  1264.             wwwDocLastNTable, the wwwDocBucketTable,
  1265.             and the wwwBucketTopNDocTable."
  1266.        INDEX       { wwwEntityIndex }
  1267.        ::= { wwwDocCtrlTable 1 }
  1268.  
  1269.    WwwDocCtrlEntry ::= SEQUENCE {
  1270.        wwwDocCtrlLastNSize                 Unsigned32,
  1271.        wwwDocCtrlLastNStatus               INTEGER,
  1272.        wwwDocCtrlBuckets                   Unsigned32,
  1273.        wwwDocCtrlBucketSize                Unsigned32,
  1274.        wwwDocCtrlBucketSort                WwwDocSort,
  1275.        wwwDocCtrlBucketTimeInterval        TimeInterval
  1276.    }
  1277.  
  1278.    wwwDocCtrlLastNSize OBJECT-TYPE
  1279.        SYNTAX      Unsigned32
  1280.        MAX-ACCESS  read-write
  1281.        STATUS      current
  1282.        DESCRIPTION
  1283.            "The maximum number of entries in the wwwDocLastNTable."
  1284.        DEFVAL { 25 }
  1285.        ::= { wwwDocCtrlEntry 1 }
  1286.  
  1287.    wwwDocCtrlLastNStatus OBJECT-TYPE
  1288.        SYNTAX      INTEGER { enabled(1), disabled(2) }
  1289.        MAX-ACCESS  read-write
  1290.        STATUS      current
  1291.        DESCRIPTION
  1292.            "Indicates whether the wwwDocLastNTable is currently
  1293.             updated by the agent or not. This object allows a
  1294.             manager to suspend the update process in order to
  1295.             read it in a consistent state."
  1296.        DEFVAL { enabled }
  1297.        ::= { wwwDocCtrlEntry 2 }
  1298.  
  1299.    wwwDocCtrlBuckets OBJECT-TYPE
  1300.        SYNTAX      Unsigned32
  1301.        MAX-ACCESS  read-write
  1302.        STATUS      current
  1303.        DESCRIPTION
  1304.            "The maximum number of buckets in the associated
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310. Expires December 1997                                          [Page 23]
  1311.  
  1312. Internet-Draft               WWW Service MIB                   July 1997
  1313.  
  1314.  
  1315.             'wwwDocBucketTopNTable' before the oldest bucket
  1316.             is deleted."
  1317.        DEFVAL { 2 }
  1318.        ::= { wwwDocCtrlEntry 3 }
  1319.  
  1320.    wwwDocCtrlBucketSize OBJECT-TYPE
  1321.        SYNTAX      Unsigned32
  1322.        MAX-ACCESS  read-write
  1323.        STATUS      current
  1324.        DESCRIPTION
  1325.            "The maximum number of entries in the associated
  1326.             'wwwDocBucketTopNTable' per bucket."
  1327.        DEFVAL { 25 }
  1328.        ::= { wwwDocCtrlEntry 4 }
  1329.  
  1330.    wwwDocCtrlBucketSort OBJECT-TYPE
  1331.        SYNTAX      WwwDocSort
  1332.        MAX-ACCESS  read-write
  1333.        STATUS      current
  1334.        DESCRIPTION
  1335.            "The sort order of the new buckets. The value is only
  1336.             important at the moment when a new bucket is
  1337.             created. Changing this value does not affect the order
  1338.             in any existing buckets."
  1339.        DEFVAL { accesses }
  1340.        ::= { wwwDocCtrlEntry 5 }
  1341.  
  1342.    wwwDocCtrlBucketTimeInterval OBJECT-TYPE
  1343.        SYNTAX      TimeInterval
  1344.        MAX-ACCESS  read-write
  1345.        STATUS      current
  1346.        DESCRIPTION
  1347.            "The time interval after which a new bucket is created."
  1348.        DEFVAL { 90000 }    -- 15 minutes (resolution .01 s)
  1349.        ::= { wwwDocCtrlEntry 6 }
  1350.  
  1351.  
  1352.    wwwDocLastNTable OBJECT-TYPE
  1353.        SYNTAX      SEQUENCE OF WwwDocLastNEntry
  1354.        MAX-ACCESS  not-accessible
  1355.        STATUS      current
  1356.        DESCRIPTION
  1357.            "The table which logs the last N access attempts."
  1358.        ::= { wwwDocumentStatistics 2 }
  1359.  
  1360.    wwwDocLastNEntry OBJECT-TYPE
  1361.        SYNTAX      WwwDocLastNEntry
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367. Expires December 1997                                          [Page 24]
  1368.  
  1369. Internet-Draft               WWW Service MIB                   July 1997
  1370.  
  1371.  
  1372.        MAX-ACCESS  not-accessible
  1373.        STATUS      current
  1374.        DESCRIPTION
  1375.            "An entry which describes a recent document access
  1376.             attempts of an entity."
  1377.        INDEX       { wwwEntityIndex, wwwDocLastNIndex }
  1378.        ::= { wwwDocLastNTable 1 }
  1379.  
  1380.    WwwDocLastNEntry ::= SEQUENCE {
  1381.        wwwDocLastNIndex            Unsigned32,
  1382.        wwwDocLastNName             WwwDocName,
  1383.        wwwDocLastNTimeStamp        DateAndTime,
  1384.        wwwDocLastNRequestType      WwwRequestType,
  1385.        wwwDocLastNResponseType     WwwResponseType,
  1386.        wwwDocLastNStatusMsg        DisplayString,
  1387.        wwwDocLastNBytes            Unsigned32
  1388.    }
  1389.  
  1390.    wwwDocLastNIndex OBJECT-TYPE
  1391.        SYNTAX      Unsigned32
  1392.        MAX-ACCESS  not-accessible
  1393.        STATUS      current
  1394.        DESCRIPTION
  1395.            "An arbitrary monotonically increasing integer number
  1396.             used for indexing the wwwDocLastNTable. The value
  1397.             starts from 1 and represents the order in which the
  1398.             documents were accessed."
  1399.        ::= { wwwDocLastNEntry 1 }
  1400.  
  1401.    wwwDocLastNName OBJECT-TYPE
  1402.        SYNTAX      WwwDocName
  1403.        MAX-ACCESS  read-only
  1404.        STATUS      current
  1405.        DESCRIPTION
  1406.            "The name of the document which was attempted to access."
  1407.        ::= { wwwDocLastNEntry 2 }
  1408.  
  1409.    wwwDocLastNTimeStamp OBJECT-TYPE
  1410.        SYNTAX      DateAndTime
  1411.        MAX-ACCESS  read-only
  1412.        STATUS      current
  1413.        DESCRIPTION
  1414.            "The date and time that this document was attempted
  1415.             to access."
  1416.        ::= { wwwDocLastNEntry 3 }
  1417.  
  1418.    wwwDocLastNRequestType OBJECT-TYPE
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424. Expires December 1997                                          [Page 25]
  1425.  
  1426. Internet-Draft               WWW Service MIB                   July 1997
  1427.  
  1428.  
  1429.        SYNTAX      WwwRequestType
  1430.        MAX-ACCESS  read-only
  1431.        STATUS      current
  1432.        DESCRIPTION
  1433.            "The protocol request type which was received by the
  1434.             server when this document access was attempted."
  1435.        ::= { wwwDocLastNEntry 4 }
  1436.  
  1437.    wwwDocLastNResponseType OBJECT-TYPE
  1438.        SYNTAX      WwwResponseType
  1439.        MAX-ACCESS  read-only
  1440.        STATUS      current
  1441.        DESCRIPTION
  1442.            "The protocol response type which was sent to the client
  1443.             as a result of this attempt to access a document."
  1444.        ::= { wwwDocLastNEntry 5 }
  1445.  
  1446.    wwwDocLastNStatusMsg OBJECT-TYPE
  1447.        SYNTAX      DisplayString
  1448.        MAX-ACCESS  read-only
  1449.        STATUS      current
  1450.        DESCRIPTION
  1451.            "This object contains a human readable description
  1452.             of the reason why the wwwDocLastNResponseType has
  1453.             been returned to the client. This object defines
  1454.             the implementation specific reason if the value
  1455.             of wwwDocLastNResponseType indicates an error.
  1456.             For example, this object can indicate that the
  1457.             requested document was not returned because a
  1458.             'soft link' which points to the document could
  1459.             not be resolved."
  1460.        ::= { wwwDocLastNEntry 6 }
  1461.  
  1462.    wwwDocLastNBytes OBJECT-TYPE
  1463.        SYNTAX      Unsigned32
  1464.        MAX-ACCESS  read-only
  1465.        STATUS      current
  1466.        DESCRIPTION
  1467.            "The number of bytes that were returned as a result of
  1468.             this attempt to access a document."
  1469.        ::= { wwwDocLastNEntry 7 }
  1470.  
  1471.  
  1472.    wwwDocBucketTable OBJECT-TYPE
  1473.        SYNTAX      SEQUENCE OF WwwDocBucketEntry
  1474.        MAX-ACCESS  not-accessible
  1475.        STATUS      current
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481. Expires December 1997                                          [Page 26]
  1482.  
  1483. Internet-Draft               WWW Service MIB                   July 1997
  1484.  
  1485.  
  1486.        DESCRIPTION
  1487.            "The table providing a per bucket administrative and summary
  1488.             information of the 'wwwDocBucketTopNTable'."
  1489.        ::= { wwwDocumentStatistics 3 }
  1490.  
  1491.    wwwDocBucketEntry OBJECT-TYPE
  1492.        SYNTAX      WwwDocBucketEntry
  1493.        MAX-ACCESS  not-accessible
  1494.        STATUS      current
  1495.        DESCRIPTION
  1496.            "An entry associated with a particular mapping in the
  1497.             wwwDocBucketTable."
  1498.        INDEX       { wwwEntityIndex, wwwDocBucketIndex }
  1499.        ::= { wwwDocBucketTable 1 }
  1500.  
  1501.    WwwDocBucketEntry ::= SEQUENCE {
  1502.        wwwDocBucketIndex           Unsigned32,
  1503.        wwwDocBucketTimeStamp       TimeStamp,
  1504.        wwwDocBucketAccesses        Unsigned32,
  1505.        wwwDocBucketDocuments       Unsigned32,
  1506.        wwwDocBucketBytes           Unsigned32,
  1507.        wwwDocBucketSort            WwwDocSort
  1508.    }
  1509.  
  1510.    wwwDocBucketIndex OBJECT-TYPE
  1511.        SYNTAX      Unsigned32
  1512.        MAX-ACCESS  not-accessible
  1513.        STATUS      current
  1514.        DESCRIPTION
  1515.            "An arbitrary monotonically increasing integer number
  1516.             used for indexing the wwwDocBucketTable. The index
  1517.             number wraps to 1 whenever the maximum value is reached."
  1518.        ::= { wwwDocBucketEntry 1 }
  1519.  
  1520.    wwwDocBucketTimeStamp OBJECT-TYPE
  1521.        SYNTAX      TimeStamp
  1522.        MAX-ACCESS  read-only
  1523.        STATUS      current
  1524.        DESCRIPTION
  1525.            "The value of sysUpTime when the bucket was created."
  1526.        ::= { wwwDocBucketEntry 2 }
  1527.  
  1528.    wwwDocBucketAccesses OBJECT-TYPE
  1529.        SYNTAX      Unsigned32
  1530.        MAX-ACCESS  read-only
  1531.        STATUS      current
  1532.        DESCRIPTION
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538. Expires December 1997                                          [Page 27]
  1539.  
  1540. Internet-Draft               WWW Service MIB                   July 1997
  1541.  
  1542.  
  1543.            "The total number of access attempts for any document
  1544.             provided by this wwwEntity during the time interval
  1545.             over which this bucket was created."
  1546.        ::= { wwwDocBucketEntry 3 }
  1547.  
  1548.    wwwDocBucketDocuments OBJECT-TYPE
  1549.        SYNTAX      Unsigned32
  1550.        MAX-ACCESS  read-only
  1551.        STATUS      current
  1552.        DESCRIPTION
  1553.            "The total number of different documents which were
  1554.             attempted to be read from this this wwwEntity during
  1555.             the time interval over which this bucket was created."
  1556.        ::= { wwwDocBucketEntry 4 }
  1557.  
  1558.    wwwDocBucketBytes OBJECT-TYPE
  1559.        SYNTAX      Unsigned32
  1560.        MAX-ACCESS  read-only
  1561.        STATUS      current
  1562.        DESCRIPTION
  1563.            "The total number of bytes  which were transferred
  1564.             from this this wwwEntity during the time interval over
  1565.             which this bucket was created."
  1566.        ::= { wwwDocBucketEntry 5 }
  1567.  
  1568.    wwwDocBucketSort OBJECT-TYPE
  1569.        SYNTAX      WwwDocSort
  1570.        MAX-ACCESS  read-only
  1571.        STATUS      current
  1572.        DESCRIPTION
  1573.            "The sort order with which this bucket was created."
  1574.        ::= { wwwDocBucketEntry 6 }
  1575.  
  1576.  
  1577.    wwwDocBucketTopNTable OBJECT-TYPE
  1578.        SYNTAX      SEQUENCE OF WwwDocBucketTopNEntry
  1579.        MAX-ACCESS  not-accessible
  1580.        STATUS      current
  1581.        DESCRIPTION
  1582.            "The table of documents accessed from any entity configured
  1583.             in the wwwEntityTable. The agent minimally adds entries to
  1584.             this table when documents that have been accessed. It may
  1585.             however choose to add entries for documents which have not
  1586.             yet been accessed as well."
  1587.        ::= { wwwDocumentStatistics 4 }
  1588.  
  1589.    wwwDocBucketTopNEntry OBJECT-TYPE
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595. Expires December 1997                                          [Page 28]
  1596.  
  1597. Internet-Draft               WWW Service MIB                   July 1997
  1598.  
  1599.  
  1600.        SYNTAX      WwwDocBucketTopNEntry
  1601.        MAX-ACCESS  not-accessible
  1602.        STATUS      current
  1603.        DESCRIPTION
  1604.            "An entry associated with a particular document in
  1605.             the wwwDocBucketTopNTable."
  1606.        INDEX       { wwwEntityIndex, wwwDocBucketIndex, wwwDocBucketTopNIndex }
  1607.        ::= { wwwDocBucketTopNTable 1 }
  1608.  
  1609.    WwwDocBucketTopNEntry ::= SEQUENCE {
  1610.        wwwDocBucketTopNIndex               Unsigned32,
  1611.        wwwDocBucketTopNName                WwwDocName,
  1612.        wwwDocBucketTopNAccesses            Unsigned32,
  1613.        wwwDocBucketTopNBytes               Unsigned32,
  1614.        wwwDocBucketTopNLastResponseType    WwwResponseType
  1615.    }
  1616.  
  1617.    wwwDocBucketTopNIndex OBJECT-TYPE
  1618.        SYNTAX      Unsigned32
  1619.        MAX-ACCESS  not-accessible
  1620.        STATUS      current
  1621.        DESCRIPTION
  1622.            "An arbitrary monotonically increasing integer number
  1623.             used for indexing the wwwDocBucketTopNTable. The index
  1624.             is inversely correlated to the sorting order of the
  1625.             table. For example, if the table is sorted according
  1626.             to document accesses, than the document with the
  1627.             highest access count will get the index value 1."
  1628.        ::= { wwwDocBucketTopNEntry 1 }
  1629.  
  1630.    wwwDocBucketTopNName OBJECT-TYPE
  1631.        SYNTAX      WwwDocName
  1632.        MAX-ACCESS  read-only
  1633.        STATUS      current
  1634.        DESCRIPTION
  1635.            "The name of the document which was attempted to access."
  1636.        ::= { wwwDocBucketTopNEntry 2 }
  1637.  
  1638.    wwwDocBucketTopNAccesses OBJECT-TYPE
  1639.        SYNTAX      Unsigned32
  1640.        MAX-ACCESS  read-only
  1641.        STATUS      current
  1642.        DESCRIPTION
  1643.            "The total number of access attempts for this document."
  1644.        ::= { wwwDocBucketTopNEntry 3 }
  1645.  
  1646.    wwwDocBucketTopNBytes OBJECT-TYPE
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652. Expires December 1997                                          [Page 29]
  1653.  
  1654. Internet-Draft               WWW Service MIB                   July 1997
  1655.  
  1656.  
  1657.        SYNTAX      Unsigned32
  1658.        MAX-ACCESS  read-only
  1659.        STATUS      current
  1660.        DESCRIPTION
  1661.            "The total number of bytes that were transmitted as
  1662.             a result of attempts to access this document."
  1663.        ::= { wwwDocBucketTopNEntry 4 }
  1664.  
  1665.    wwwDocBucketTopNLastResponseType OBJECT-TYPE
  1666.        SYNTAX      WwwResponseType
  1667.        MAX-ACCESS  read-only
  1668.        STATUS      current
  1669.        DESCRIPTION
  1670.            "The protocol response type which was sent to the client
  1671.             as a result of the last attempt to access this document."
  1672.        ::= { wwwDocBucketTopNEntry 5 }
  1673.  
  1674.  
  1675.    -- Conformance and Compliance Definitions
  1676.    --
  1677.  
  1678.    wwwMIBEntityGroup OBJECT-GROUP
  1679.        OBJECTS {
  1680.            wwwEntityDescription,
  1681.            wwwEntityContact,
  1682.            wwwEntityProtocol,
  1683.            wwwEntityName,
  1684.            wwwEntityType,
  1685.            wwwEntityUptime,
  1686.            wwwEntityOperStatus,
  1687.            wwwEntityLastChange
  1688.        }
  1689.        STATUS      current
  1690.        DESCRIPTION
  1691.            ""
  1692.        ::= { wwwMIBGroups 1 }
  1693.  
  1694.    wwwMIBSummaryGroup OBJECT-GROUP
  1695.        OBJECTS {
  1696.            wwwSummaryInRequests,
  1697.            wwwSummaryOutRequests,
  1698.            wwwSummaryInResponses,
  1699.            wwwSummaryOutResponses,
  1700.            wwwSummaryInBytes,
  1701.            wwwSummaryOutBytes
  1702.        }
  1703.        STATUS      current
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709. Expires December 1997                                          [Page 30]
  1710.  
  1711. Internet-Draft               WWW Service MIB                   July 1997
  1712.  
  1713.  
  1714.        DESCRIPTION
  1715.            ""
  1716.        ::= { wwwMIBGroups 2 }
  1717.  
  1718.    wwwMIBRequestInGroup OBJECT-GROUP
  1719.        OBJECTS {
  1720.            wwwRequestInCount,
  1721.            wwwRequestInBytes,
  1722.            wwwRequestInLastTime
  1723.        }
  1724.        STATUS      current
  1725.        DESCRIPTION
  1726.            ""
  1727.        ::= { wwwMIBGroups 3 }
  1728.  
  1729.    wwwMIBRequestOutGroup OBJECT-GROUP
  1730.        OBJECTS {
  1731.            wwwRequestOutCount,
  1732.            wwwRequestOutBytes,
  1733.            wwwRequestOutLastTime
  1734.        }
  1735.        STATUS      current
  1736.        DESCRIPTION
  1737.            ""
  1738.        ::= { wwwMIBGroups 4 }
  1739.  
  1740.    wwwMIBResponseInGroup OBJECT-GROUP
  1741.        OBJECTS {
  1742.            wwwResponseInCount,
  1743.            wwwResponseInBytes,
  1744.            wwwResponseInLastTime
  1745.        }
  1746.        STATUS      current
  1747.        DESCRIPTION
  1748.            ""
  1749.        ::= { wwwMIBGroups 5 }
  1750.  
  1751.    wwwMIBResponseOutGroup OBJECT-GROUP
  1752.        OBJECTS {
  1753.            wwwResponseOutCount,
  1754.            wwwResponseOutBytes,
  1755.            wwwResponseOutLastTime
  1756.        }
  1757.        STATUS      current
  1758.        DESCRIPTION
  1759.            ""
  1760.        ::= { wwwMIBGroups 6 }
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766. Expires December 1997                                          [Page 31]
  1767.  
  1768. Internet-Draft               WWW Service MIB                   July 1997
  1769.  
  1770.  
  1771.    wwwMIBDocumentGroup OBJECT-GROUP
  1772.        OBJECTS {
  1773.            wwwDocCtrlLastNSize,
  1774.            wwwDocCtrlLastNStatus,
  1775.            wwwDocCtrlBuckets,
  1776.            wwwDocCtrlBucketSize,
  1777.            wwwDocCtrlBucketSort,
  1778.            wwwDocCtrlBucketTimeInterval,
  1779.            wwwDocLastNName,
  1780.            wwwDocLastNTimeStamp,
  1781.            wwwDocLastNRequestType,
  1782.            wwwDocLastNResponseType,
  1783.            wwwDocLastNStatusMsg,
  1784.            wwwDocLastNBytes,
  1785.            wwwDocBucketTimeStamp,
  1786.            wwwDocBucketAccesses,
  1787.            wwwDocBucketDocuments,
  1788.            wwwDocBucketBytes,
  1789.            wwwDocBucketSort,
  1790.            wwwDocBucketTopNName,
  1791.            wwwDocBucketTopNAccesses,
  1792.            wwwDocBucketTopNBytes,
  1793.            wwwDocBucketTopNLastResponseType
  1794.        }
  1795.        STATUS  current
  1796.        DESCRIPTION
  1797.            ""
  1798.        ::= { wwwMIBGroups 7 }
  1799.  
  1800.    wwwMinimalCompliance MODULE-COMPLIANCE
  1801.        STATUS      current
  1802.        DESCRIPTION
  1803.            "The compliance statement for SNMP entities which implement
  1804.             the minimal subset of the WWW-MIB. Implementors might
  1805.             choose this subset for high-performance server where full
  1806.             compliance might be to expensive."
  1807.        MODULE  -- this module
  1808.        MANDATORY-GROUPS {
  1809.            wwwMIBEntityGroup,
  1810.            wwwMIBSummaryGroup
  1811.        }
  1812.        ::= { wwwMIBCompliances 1 }
  1813.  
  1814.    wwwFullCompliance MODULE-COMPLIANCE
  1815.        STATUS      current
  1816.        DESCRIPTION
  1817.            "The compliance statement for SNMP entities which implement
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823. Expires December 1997                                          [Page 32]
  1824.  
  1825. Internet-Draft               WWW Service MIB                   July 1997
  1826.  
  1827.  
  1828.             the full WWW-MIB."
  1829.        MODULE  -- this module
  1830.        MANDATORY-GROUPS {
  1831.            wwwMIBEntityGroup,
  1832.            wwwMIBSummaryGroup,
  1833.            wwwMIBRequestInGroup,
  1834.            wwwMIBRequestOutGroup,
  1835.            wwwMIBResponseInGroup,
  1836.            wwwMIBResponseOutGroup,
  1837.            wwwMIBDocumentGroup
  1838.        }
  1839.        ::= { wwwMIBCompliances 2 }
  1840.  
  1841.    END
  1842.  
  1843.  
  1844. 7.  References
  1845.  
  1846. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1847.      Waldbusser, "Structure of Management Information for Version 2 of
  1848.      the Simple Network Management Protocol (SNMPv2)", RFC1902, SNMP
  1849.      Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  1850.      International Network Services, January 1996.
  1851.  
  1852. [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  1853.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  1854.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  1855.      March 1991.
  1856.  
  1857. [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  1858.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  1859.      International, Performance Systems International, MIT Laboratory
  1860.      for Computer Science, May 1990.
  1861.  
  1862. [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S.
  1863.      Waldbusser, "Protocol Operations for Version 2 of the Simple
  1864.      Network Management Protocol (SNMPv2)", RFC1905, SNMP Research,Inc.,
  1865.      Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  1866.      Network Services, January 1996.
  1867.  
  1868. [5]  Berners-Lee, T., Masinter, L., and M. McCahill, "Uniform Resource
  1869.      Locators (URL)", RFC 1738, CERN, Xerox Corporation, University of
  1870.      Minnesota, December 1994.
  1871.  
  1872. [6]  T. Berners-Lee, "Universal Resource Identifiers in WWW", RFC 1630,
  1873.      CERN, June 1994.
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880. Expires December 1997                                          [Page 33]
  1881.  
  1882. Internet-Draft               WWW Service MIB                   July 1997
  1883.  
  1884.  
  1885. [7]  D. Crocker, "STANDARD FOR THE FORMAT OF ARPA INTERNET TEXT
  1886.      MESSAGES", RFC 822, University of Delaware, August 1982.
  1887.  
  1888. [8]  C. Kalbfleisch, "Applicability of Standards Track MIBs to
  1889.      Management of World Wide Web Servers", RFC 2039, OnRamp
  1890.      Technologies, November 1996.
  1891.  
  1892. [9]  Krupczak, C., and J. Saperia, "Definitions of System-Level Managed
  1893.      Objects for Applications", draft-ietf-applmib-sysapplmib-08.txt,
  1894.      Empire Technologies, BGS Systems, March 1997.
  1895.  
  1896. [10] Kalbfleisch, C., Krupczak, C., Preshun, R., and J. Saperia,
  1897.      "Application Management MIB", draft-ietf-applmib-mib-03.txt, Verio,
  1898.      Empire Technologies, BMC Software, BGS Systems, March 1997.
  1899.  
  1900. [11] Berners-Lee, T., Fielding, R., and H. Frystyk, "Hypertext Transfer
  1901.      Protocol -- HTTP/1.0", RFC 1945, MIT/LCS, UC Irvine, MIT/LCS, May
  1902.      1996.
  1903.  
  1904. [12] Fielding, R., Gettys, J., Mogul, J., Frystyk, H., and T. Berners-
  1905.      Lee, "Hypertext Transfer Protocol -- HTTP/1.1", RFC 2068, UC
  1906.      Irvine, DEC, DEC, MIT/LCS, January 1997.
  1907.  
  1908. [13] Postel, J., and J.K. Reynolds, "File Transfer Protocol (FTP)", STD
  1909.      9, RFC 959, USC/ISI, October 1985.
  1910.  
  1911. [14] Kantor, B., and P. Lapsley, "Network News Transfer Protocol: A
  1912.      Proposed Standard for the Stream-Based Transmission of News", RFC
  1913.      977, UC San Diego & UC Berkeley, February 1986.
  1914.  
  1915. [15] Horton, M., and R. Adams, "Standard for interchange of USENET
  1916.      messages", RFC 1036, AT&T Bell Laboratories, Center for Seismic
  1917.      Studies, December 1987.
  1918.  
  1919.  
  1920. 8.  Acknowledgments
  1921.  
  1922.    This document was produced by the Application MIB working group.
  1923.  
  1924.    The authors gratefully acknowledge the comments of the following
  1925.    individuals:
  1926.  
  1927.                 Mark Gamble
  1928.                 Cheryl Krupczak
  1929.                 Randy Preshun
  1930.                 John Saperia
  1931.                 Bob Stewart
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937. Expires December 1997                                          [Page 34]
  1938.  
  1939. Internet-Draft               WWW Service MIB                   July 1997
  1940.  
  1941.  
  1942.                 Martin Toet
  1943.                 Chris Wellens
  1944.  
  1945.  
  1946. 9.  Security Considerations
  1947.  
  1948.    The MIB objects defined in the memo might disclose information that
  1949.    should be protected. In particular, the document statistics group
  1950.    contains traffic information, which includes the names of documents
  1951.    that were a target of a protocol operation. It is therefore adviced
  1952.    to use SNMP access control and SNMP security mechanism (where
  1953.    available) in order to protect this information in sensitive
  1954.    environments.
  1955.  
  1956.    The service statistics are less sensitive, because they do not
  1957.    contain details about the target of individual requests/responses.
  1958.    However, it is suggested that sites configure MIB views so that a
  1959.    user of this MIB can only see the portion of the statistics that
  1960.    belong to the WWW entities managed by that user.
  1961.  
  1962.  
  1963. 10.  Document Transfer Protocol Mappings
  1964.  
  1965.    This appendix describes how existing protocols such as HTTP [13,14]
  1966.    and FTP [15] can be mapped on the abstract Document Transfer Protocol
  1967.    (DTP) used within the definitions of the WWW MIB. Every mapping must
  1968.    define the identifier which is used to uniquely identify the transfer
  1969.    protocol. In addition, the mappings must define how requests and
  1970.    responses are identified.
  1971.  
  1972.  
  1973. 10.1.  The HyperText Transfer Protocol
  1974.  
  1975.    The HyperText Transfer Protocol (HTTP) [13,14] is an application-
  1976.    level protocol used to transfer hypermedia documents in a distributed
  1977.    networked environment. HTTP is based on the request/response paradigm
  1978.    and can be mapped on the abstract DTP easily.
  1979.  
  1980.    The HTTP protocol usually runs over TCP and uses the well-known TCP
  1981.    port 80. Therefore, the default value for the wwwEntityProtocol
  1982.    object is { applTCPProtoID 80 }.
  1983.  
  1984.    HTTP allows for both requests and responses an open-ended set of
  1985.    message types. The general messages syntax of HTTP is therefore used
  1986.    for the protocol mapping. The BNF specification of the general HTTP
  1987.    message syntax as defined in [12] is as follows:
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994. Expires December 1997                                          [Page 35]
  1995.  
  1996. Internet-Draft               WWW Service MIB                   July 1997
  1997.  
  1998.  
  1999.        HTTP-message = start-line
  2000.                       *message-header
  2001.                       CRLF
  2002.                       [ message-body ]
  2003.  
  2004.        start-line   = Request-Line | Status-Line
  2005.  
  2006.        Request-Line = Method SP Request-URI SP HTTP-Version CRLF
  2007.  
  2008.        Status-Line  = HTTP-Version SP Status-Code SP Reason-Phrase CRLF
  2009.  
  2010.    Every HTTP-message where the start-line is a Request-Line is
  2011.    considered a request in the abstract DTP. Every HTTP-message where
  2012.    the start-line is a Status-Line is considered a response in the
  2013.    abstract DTP. The rest of the mappings are defined as follows:
  2014.  
  2015.    o    The wwwRequestType corresponds to the method token in the
  2016.         Request-Line.
  2017.  
  2018.    o    The wwwResponseType corresponds to the Status-Code in the
  2019.         Status-Line.
  2020.  
  2021.  
  2022. 10.2.  The File Transfer Protocol
  2023.  
  2024.    The File Transfer Protocol (FTP) [13] is an application-level
  2025.    protocol used to transfer files between hosts connected by the TCP/IP
  2026.    suite of protocols. FTP is based on a request/response paradigm and
  2027.    can be mapped on the abstract DTP as defined in this section. The FTP
  2028.    model as defined in [13] is depicted below.
  2029.  
  2030.                                               -------------
  2031.                                               |+---------+|
  2032.                                               ||   User  ||    --------
  2033.                                               ||Interface|<--->| User |
  2034.                                               |+----|----+|    --------
  2035.                 ----------                    |     |     |
  2036.                 |+------+| control connection |+----|----+|
  2037.                 ||Server|<------------------->||  Client ||
  2038.                 ||  PI  ||  Commands/Replies  ||    PI   ||
  2039.                 |+--|---+|                    |+----|----+|
  2040.                 |   |    |                    |     |     |
  2041.     --------    |+--|---+|        Data        |+----|----+|    --------
  2042.     | File |<--->|Server|<------------------->||  Client |<--->| File |
  2043.     |System|    || DTP  ||     Connection     ||   DTP   ||    |System|
  2044.     --------    |+------+|                    |+---------+|    --------
  2045.                 ----------                    -------------
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051. Expires December 1997                                          [Page 36]
  2052.  
  2053. Internet-Draft               WWW Service MIB                   July 1997
  2054.  
  2055.  
  2056.    FTP uses two different connection types between a client and a server
  2057.    to transfer files. The control connection is persistent during a FTP
  2058.    session and used to exchange FTP commands and associated replies. The
  2059.    data connection is only available when bulk data has to be
  2060.    transferred.
  2061.  
  2062.    The FTP protocol usually runs over TCP and uses the well-known TCP
  2063.    port 21 to setup the control connection. Therefore, the default value
  2064.    for the wwwEntityProtocol object is { applTCPProtoID 21 }.
  2065.  
  2066.    Every FTP command is considered a request in the abstract DTP. Every
  2067.    FTP reply is considered a response in the abstract DTP. It should be
  2068.    noted that a single FTP command can result in multiple FTP replies
  2069.    (e.g. preliminary positive replies). The definition above maps
  2070.    multiple FTP replies into multiple DTP responses. The rest of the
  2071.    mappings are defined as follows:
  2072.  
  2073.    o    The wwwRequestType corresponds to the FTP command token.
  2074.  
  2075.    o    The wwwResponseType corresponds to the three-digit code which
  2076.         starts a reply. Multi-line replies with the same three-digit
  2077.         code are counted as a single DTP response.
  2078.  
  2079.  
  2080. 11.  Todo List
  2081.  
  2082.    This section will be removed when the document is complete because
  2083.    all items that are "to do" will have been done!
  2084.  
  2085.  
  2086.    o    Check if we need additional objects or clarifications to handle
  2087.         proxies and caching proxies.
  2088.  
  2089.    o    Check if the wwwDocLastNTable and the wwwDocBucketTopNTable can
  2090.         be changed to solve the multiple manager problem.
  2091.  
  2092.    o    Do we need additional objects in the wwwDocLastNTable, e.g. user
  2093.         or client address?
  2094.  
  2095.    o    Remove wwwDocBucketTopNLastResponseType? Or even add something
  2096.         like wwwDocBucketTopNLastStatusMsg?
  2097.  
  2098.    o    Do we need a definition for "read attempts"? Check whether the
  2099.         wordings are consistent throughout the document.
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108. Expires December 1997                                          [Page 37]
  2109.  
  2110. Internet-Draft               WWW Service MIB                   July 1997
  2111.  
  2112.  
  2113. 12.  Authors' Address
  2114.  
  2115.  
  2116.      Harrie Hazewinkel
  2117.      MUSIQ/DESIRE/CEO Program
  2118.      Institute for Space Applications
  2119.      Joint Research Centre of the E.C.
  2120.      TP. 950
  2121.      Ispra 21020 (VA) Italy              Tel: +39+(0)332+789384
  2122.      harrie.hazewinkel@jrc.it            Fax: +39+(0)332+785500
  2123.  
  2124.      Carl W. Kalbfleisch
  2125.      Verio, Inc.
  2126.      1950 Stemmons Frwy
  2127.      2004 INFOMART
  2128.      Dallas, TX 75207
  2129.      USA                                 Tel: +1 972 238-8303
  2130.      cwk@verio.net                       Fax: +1 972 238-0268
  2131.  
  2132.      Juergen Schoenwaelder
  2133.      Computer Science Department
  2134.      University of Twente
  2135.      P.O. Box 217, NL-7500 AE Enschede
  2136.      The Netherlands                     Tel: +31 53 489-3678
  2137.      schoenw@cs.utwente.nl               Fax: +31 53 489-3247
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165. Expires December 1997                                          [Page 38]
  2166.  
  2167. Internet-Draft               WWW Service MIB                   July 1997
  2168.  
  2169.  
  2170.    Table of Contents
  2171.  
  2172.  
  2173.    1 Abstract .....................................................    2
  2174.    2 The SNMPv2 Network Management Framework ......................    2
  2175.    2.1 Object Definitions .........................................    2
  2176.    3 Terminology ..................................................    3
  2177.    4 Overview .....................................................    4
  2178.    4.1 Purpose and Requirements ...................................    4
  2179.    4.2 Relationship to other Standards Efforts ....................    5
  2180.    4.3 WWW Entities ...............................................    5
  2181.    4.4 Document Transfer Protocol .................................    6
  2182.    5 Structure of the MIB .........................................    6
  2183.    5.1 Entity Group ...............................................    7
  2184.    5.2 Service Statistics Group ...................................    7
  2185.    5.3 Document Statistics Group ..................................    8
  2186.    6 Definitions ..................................................    9
  2187.    7 References ...................................................   33
  2188.    8 Acknowledgments ..............................................   34
  2189.    9 Security Considerations ......................................   35
  2190.    10 Document Transfer Protocol Mappings .........................   35
  2191.    10.1 The HyperText Transfer Protocol ...........................   35
  2192.    10.2 The File Transfer Protocol ................................   36
  2193.    11 Todo List ...................................................   37
  2194.    12 Authors' Address ............................................   38
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222. Expires December 1997                                          [Page 39]
  2223.  
  2224.