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