home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_j_p / draft-ietf-madman-nsm-mib-03.txt < prev    next >
Text File  |  1996-11-05  |  34KB  |  1,294 lines
  1.  
  2.  
  3. Network Working Group                                          Ned Freed
  4. Internet Draft                        <draft-ietf-madman-nsm-mib-03.txt>
  5.  
  6.  
  7.  
  8.                     Network Services Monitoring MIB
  9.  
  10.                              November 1996
  11.  
  12.  
  13.  
  14.  
  15.                           Status of this Memo
  16.  
  17. This document is an Internet-Draft.  Internet-Drafts are working
  18. documents of the Internet Engineering Task Force (IETF), its areas, and
  19. its working groups. Note that other groups may also distribute working
  20. documents as Internet-Drafts.
  21.  
  22. Internet-Drafts are draft documents valid for a maximum of six months.
  23. Internet-Drafts may be updated, replaced, or obsoleted by other
  24. documents at any time.  It is not appropriate to use Internet-Drafts as
  25. reference material or to cite them other than as a "working draft" or
  26. "work in progress".
  27.  
  28. To learn the current status of any Internet-Draft, please check the
  29. 1id-abstracts.txt listing contained in the Internet-Drafts Shadow
  30. Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe),
  31. ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim).
  32.  
  33.  
  34. 1.  Introduction
  35.  
  36. A networked application is a realization of some well defined service on
  37. one or more host computers that is accessible via some network, uses
  38. some network for its internal operations, or both.
  39.  
  40. There are a wide range of networked applications for which it is
  41. appropriate to provide SNMP monitoring of their network usage.  This
  42. includes applications using both TCP/IP and OSI networking.  This
  43. document defines a MIB which contains the elements common to the
  44. monitoring of any network service application.  This information
  45. includes a table of all monitorable network service applications, a
  46. count of the associations (connections) to each application, and basic
  47. information about the parameters and status of each application-related
  48. association.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59. Internet Draft      Network Services Monitoring MIB        November 1996
  60.  
  61.  
  62.  
  63.  
  64. This MIB may be used on its own for any application, and for most simple
  65. applications this will suffice.  This MIB is also designed to serve as a
  66. building block which can be used in conjunction with application-
  67. specific monitoring and management.  Two examples of this are MIBs
  68. defining additional variables for monitoring a Message Transfer Agent
  69. (MTA) service or a Directory Service Agent (DSA) service. It is expected
  70. that further MIBs of this nature will be specified.
  71.  
  72. This MIB does not attempt to provide facilities for management of the
  73. host or hosts the network service application runs on, nor does it
  74. provide facilities for monitoring applications that provide something
  75. other than a network service.  Host resource and general application
  76. monitoring is handled by the Host Resources MIB at present; development
  77. of an additional application MIB is currently underway in the IETF.
  78.  
  79.  
  80. 2.  Table of Contents
  81.  
  82. 1 Introduction ....................................................    1
  83. 2 Table of Contents ...............................................    2
  84. 3 The SNMPv2 Network Management Framework .........................    2
  85. 3.1 Object Definitions ............................................    3
  86. 4 Rationale for having a Network Services Monitoring MIB ..........    3
  87. 4.1 General Relationship to Other MIBs ............................    4
  88. 4.2 Restriction of Scope ..........................................    4
  89. 4.3 Relationship to Directory Services ............................    5
  90. 5 Application Objects .............................................    6
  91. 6 Definitions .....................................................    6
  92. 7 Changes made since RFC 1565 .....................................   20
  93. 8 Acknowledgements ................................................   21
  94. 9 References ......................................................   21
  95. 10 Security Considerations ........................................   22
  96. 11 Author and Chair Addresses .....................................   22
  97.  
  98.  
  99. 3.  The SNMPv2 Network Management Framework
  100.  
  101. The SNMPv2 Network Management Framework consists of seven major
  102. components. They are:
  103.  
  104. o    RFC 1902 [1] which defines the SMI, the mechanisms used for
  105.      describing and naming objects for the purpose of management.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112. Expires May 1997                                                [Page 2]
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Internet Draft      Network Services Monitoring MIB        November 1996
  119.  
  120.  
  121. o    RFC 1903 [2] defines textual conventions for SNMPv2.
  122.  
  123. o    RFC 1904 [3] defines conformance statements for SNMPv2.
  124.  
  125. o    RFC 1905 [4] defines  transport mappings for SNMPv2.
  126.  
  127. o    RFC 1906 [5] defines the protocol operations used for network
  128.      access to managed objects.
  129.  
  130. o    RFC 1907 [6] defines the Management Information Base for SNMPv2.
  131.  
  132. o    RFC 1908 [7] specifies coexistance between SNMP and SNMPv2.
  133.  
  134. The Framework permits new objects to be defined for the purpose of
  135. experimentation and evaluation.
  136.  
  137.  
  138. 3.1.  Object Definitions
  139.  
  140. Managed objects are accessed via a virtual information store, termed the
  141. Management Information Base or MIB. Objects in the MIB are defined using
  142. the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI.
  143. In particular, each object type is named by an OBJECT IDENTIFIER, an
  144. administratively assigned name. The object type together with an object
  145. instance serves to uniquely identify a specific instantiation of the
  146. object.  For human convenience, we often use a textual string, termed
  147. the descriptor, to refer to the object type.
  148.  
  149.  
  150. 4.  Rationale for having a Network Services Monitoring MIB
  151.  
  152. Much effort has been expended in developing tools to manage lower layer
  153. network facilities.  However, relatively little work has been done on
  154. managing application layer entities.  It is neither efficient nor
  155. reasonable to manage all aspects of application layer entities using
  156. only lower layer information.  Moreover, the difficulty of managing
  157. application entities in this way increases dramatically as application
  158. entities become more complex.
  159.  
  160. This leads to a substantial need to monitor applications which provide
  161. network services, particularly distributed components such as MTAs and
  162. DSAs, by monitoring specific aspects of the application itself.  Reasons
  163. to monitor such components include but are not limited to measuring
  164. load, detecting broken connectivity, isolating system failures, and
  165. locating congestion.
  166.  
  167.  
  168.  
  169.  
  170.  
  171. Expires May 1997                                                [Page 3]
  172.  
  173.  
  174.  
  175.  
  176.  
  177. Internet Draft      Network Services Monitoring MIB        November 1996
  178.  
  179.  
  180. In order to manage network service applications effectively two
  181. requirements must be met:
  182.  
  183.  (1)   It must be possible to monitor a large number of components
  184.        (typical for a large organization).
  185.  
  186.  (2)   Application monitoring must be integrated into general network
  187.        management.
  188.  
  189. This specification defines simple read-only access; this is sufficient
  190. to determine up/down status and provide an indication of a broad class
  191. of operational problems.
  192.  
  193.  
  194. 4.1.  General Relationship to Other MIBs
  195.  
  196. This MIB is intended to only provide facilities common to the monitoring
  197. of any network service application.  It does not provide all the
  198. facilities necessary to monitor any specific application.  Each specific
  199. type of network service application is expected to have a MIB of its own
  200. that makes use of these common facilities.
  201.  
  202.  
  203. 4.2.  Restriction of Scope
  204.  
  205. The framework provided here is very minimal; there is a lot more that
  206. could be done. For example:
  207.  
  208.  (1)   General network service application configuration monitoring and
  209.        control.
  210.  
  211.  (2)   Detailed examination and modification of individual entries in
  212.        service-specific request queues.
  213.  
  214.  (3)   Probing to determine the status of a specific request (e.g. the
  215.        location of a mail message with a specific message-id).
  216.  
  217.  (4)   Requesting that certain actions be performed (e.g. forcing an
  218.        immediate connection and transfer of pending messages to some
  219.        specific system).
  220.  
  221. All these capabilities are both impressive and useful.  However, these
  222. capabilities would require provisions for strict security checking.
  223. These capabilities would also mandate a much more complex design, with
  224. many characteristics likely to be fairly implementation-specific.  As a
  225.  
  226.  
  227.  
  228.  
  229.  
  230. Expires May 1997                                                [Page 4]
  231.  
  232.  
  233.  
  234.  
  235.  
  236. Internet Draft      Network Services Monitoring MIB        November 1996
  237.  
  238.  
  239. result such facilities are likely to be both contentious and difficult
  240. to implement.
  241.  
  242. This document religiously keeps things simple and focuses on the basic
  243. monitoring aspect of managing applications providing network services.
  244. The goal here is to provide a framework which is simple, useful, and
  245. widely implementable.
  246.  
  247.  
  248. 4.3.  Relationship to Directory Services
  249.  
  250. Use of and management of directory services already is tied up with
  251. network service application management.  There are clearly many things
  252. which could be dealt with by directory services and protocols.  We take
  253. the line here that static configuration information is both provided by
  254. and dealt with by directory services and protocols.  The emphasis here
  255. is on transient application status.
  256.  
  257. By placing static information in the directory, the richness and linkage
  258. of the directory information framework does not need to be repeated in
  259. the MIB.  Static information is information which has a mean time to
  260. change of the order of days or longer.
  261.  
  262. When information about network service applications is stored in the
  263. directory (regardless of whether or not the network service application
  264. makes direct use of the directory), it is recommended that a linkage be
  265. established, so that:
  266.  
  267.  (1)   The managed object contains its own directory name.  This allows
  268.        all directory information to be obtained by reference.  This will
  269.        let a SNMP monitor capable of performing directory queries
  270.        present this information to the manager in an appropriate format.
  271.        It is intended that this will be the normal case.
  272.  
  273.  (2)   The directory will reference the location of the SNMP agent, so
  274.        that an SNMP capable directory query agent could probe dynamic
  275.        characteristics of the object.
  276.  
  277.  (3)   This approach could be extended further, so that the SNMP
  278.        attributes are modelled as directory attributes.  This would
  279.        dramatically simplify the design of directory service agents that
  280.        use SNMP to obtain the information they need.
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289. Expires May 1997                                                [Page 5]
  290.  
  291.  
  292.  
  293.  
  294.  
  295. Internet Draft      Network Services Monitoring MIB        November 1996
  296.  
  297.  
  298. 5.  Application Objects
  299.  
  300. This MIB defines a set of general purpose attributes which would be
  301. appropriate for a range of applications that provide network services.
  302. Both OSI and non-OSI services can be accomodated.  Additional tables
  303. defined in extensions to this MIB provide attributes specific to
  304. specific network services.
  305.  
  306. A table is defined which will have one row for each operational network
  307. service application on the system.  The only static information held on
  308. the application is its name.  All other static information should be
  309. obtained from various directory services.  The applDirectoryName is an
  310. external key, which allows an SNMP MIB entry to be cleanly related to
  311. the X.500 Directory.  In SNMP terms, the applications are grouped in a
  312. table called applTable, which is indexed by an integer key applIndex.
  313.  
  314. The type of the application will be determined by one or both of:
  315.  
  316.  (1)   Additional MIB variables specific to the applications.
  317.  
  318.  (2)   An association to the application of a specific protocol.
  319.  
  320.  
  321. 6.  Definitions
  322.  
  323. NETWORK-SERVICES-MIB DEFINITIONS ::= BEGIN
  324.  
  325. IMPORTS
  326.     OBJECT-TYPE, Counter32, Gauge32, MODULE-IDENTITY
  327.       FROM SNMPv2-SMI
  328.     mib-2
  329.       FROM RFC1213-MIB
  330.     DisplayString, TimeStamp, TEXTUAL-CONVENTION
  331.       FROM SNMPv2-TC
  332.     MODULE-COMPLIANCE, OBJECT-GROUP
  333.       FROM SNMPv2-CONF;
  334.  
  335.  
  336. -- Textual conventions
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348. Expires May 1997                                                [Page 6]
  349.  
  350.  
  351.  
  352.  
  353.  
  354. Internet Draft      Network Services Monitoring MIB        November 1996
  355.  
  356.  
  357. -- DistinguishedName is used to refer to objects in the
  358. -- directory.
  359.  
  360. DistinguishedName ::= TEXTUAL-CONVENTION
  361.     STATUS current
  362.     DESCRIPTION
  363.         "A Distinguished Name represented in accordance with
  364.          RFC 1779 [8]."
  365.     SYNTAX DisplayString
  366.  
  367. -- Uniform Resource Locators are stored in URLStrings.
  368.  
  369. URLString ::= TEXTUAL-CONVENTION
  370.     STATUS current
  371.     DESCRIPTION
  372.         "A Uniform Resource Locator represented in accordance
  373.          with RFC 1738 [10]."
  374.     SYNTAX DisplayString
  375.  
  376. application MODULE-IDENTITY
  377.     LAST-UPDATED "9609030000Z"
  378.     ORGANIZATION "IETF Mail and Directory Management Working Group"
  379.     CONTACT-INFO
  380.       "        Ned Freed
  381.  
  382.        Postal: Innosoft International, Inc.
  383.                1050 East Garvey Avenue South
  384.                West Covina, CA 91790
  385.                US
  386.  
  387.           Tel: +1 818 919 3600
  388.           Fax: +1 818 919 3614
  389.  
  390.        E-Mail: ned@innosoft.com"
  391.     DESCRIPTION
  392.       "The MIB module describing network service applications"
  393.     ::= {mib-2 27}
  394.  
  395. -- The basic applTable contains a list of the application
  396. -- entities.
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407. Expires May 1997                                                [Page 7]
  408.  
  409.  
  410.  
  411.  
  412.  
  413. Internet Draft      Network Services Monitoring MIB        November 1996
  414.  
  415.  
  416. applTable OBJECT-TYPE
  417.     SYNTAX SEQUENCE OF ApplEntry
  418.     MAX-ACCESS not-accessible
  419.     STATUS current
  420.     DESCRIPTION
  421.         "The table holding objects which apply to all different
  422.          kinds of applications providing network services.
  423.          Each network service application capable of being
  424.          monitored should have a single entry in this table."
  425.     ::= {application 1}
  426.  
  427. applEntry OBJECT-TYPE
  428.     SYNTAX ApplEntry
  429.     MAX-ACCESS not-accessible
  430.     STATUS current
  431.     DESCRIPTION
  432.       "An entry associated with a single network service
  433.        application."
  434.     INDEX {applIndex}
  435.     ::= {applTable 1}
  436.  
  437. ApplEntry ::= SEQUENCE {
  438.     applIndex
  439.         INTEGER,
  440.     applName
  441.         DisplayString,
  442.     applDirectoryName
  443.         DistinguishedName,
  444.     applVersion
  445.         DisplayString,
  446.     applUptime
  447.         TimeStamp,
  448.     applOperStatus
  449.         INTEGER,
  450.     applLastChange
  451.         TimeStamp,
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. Expires May 1997                                                [Page 8]
  467.  
  468.  
  469.  
  470.  
  471.  
  472. Internet Draft      Network Services Monitoring MIB        November 1996
  473.  
  474.  
  475.     applInboundAssociations
  476.         Gauge32,
  477.     applOutboundAssociations
  478.         Gauge32,
  479.     applAccumulatedInboundAssociations
  480.         Counter32,
  481.     applAccumulatedOutboundAssociations
  482.         Counter32,
  483.     applLastInboundActivity
  484.         TimeStamp,
  485.     applLastOutboundActivity
  486.         TimeStamp,
  487.     applRejectedInboundAssociations
  488.         Counter32,
  489.     applFailedOutboundAssociations
  490.         Counter32,
  491.     applDescription
  492.         DisplayString,
  493.     applURL
  494.         URLString
  495. }
  496.  
  497. applIndex OBJECT-TYPE
  498.     SYNTAX INTEGER (1..2147483647)
  499.     MAX-ACCESS not-accessible
  500.     STATUS current
  501.     DESCRIPTION
  502.       "An index to uniquely identify the network service
  503.        application. This attribute is the index used for
  504.        lexicographic ordering of the table."
  505.     ::= {applEntry 1}
  506.  
  507. applName OBJECT-TYPE
  508.     SYNTAX DisplayString
  509.     MAX-ACCESS read-only
  510.     STATUS current
  511.     DESCRIPTION
  512.       "The name the network service application chooses to be
  513.        known by."
  514.     ::= {applEntry 2}
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525. Expires May 1997                                                [Page 9]
  526.  
  527.  
  528.  
  529.  
  530.  
  531. Internet Draft      Network Services Monitoring MIB        November 1996
  532.  
  533.  
  534. applDirectoryName OBJECT-TYPE
  535.     SYNTAX DistinguishedName
  536.     MAX-ACCESS read-only
  537.     STATUS current
  538.     DESCRIPTION
  539.       "The Distinguished Name of the directory entry where
  540.        static information about this application is stored.
  541.        An empty string indicates that no information about
  542.        the application is available in the directory."
  543.     ::= {applEntry 3}
  544.  
  545. applVersion OBJECT-TYPE
  546.     SYNTAX DisplayString
  547.     MAX-ACCESS read-only
  548.     STATUS current
  549.     DESCRIPTION
  550.       "The version of network service application software.
  551.        This field is usually defined by the vendor of the
  552.        network service application software."
  553.     ::= {applEntry 4}
  554.  
  555. applUptime OBJECT-TYPE
  556.     SYNTAX TimeStamp
  557.     MAX-ACCESS read-only
  558.     STATUS current
  559.     DESCRIPTION
  560.       "The value of sysUpTime at the time the network service
  561.        application was last initialized.  If the application was
  562.        last initialized prior to the last initialization of the
  563.        network management subsystem, then this object contains
  564.        a zero value."
  565.     ::= {applEntry 5}
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584. Expires May 1997                                               [Page 10]
  585.  
  586.  
  587.  
  588.  
  589.  
  590. Internet Draft      Network Services Monitoring MIB        November 1996
  591.  
  592.  
  593. applOperStatus OBJECT-TYPE
  594.     SYNTAX INTEGER {
  595.       up(1),
  596.       down(2),
  597.       halted(3),
  598.       congested(4),
  599.       restarting(5),
  600.       quiescing(6)
  601.     }
  602.     MAX-ACCESS read-only
  603.     STATUS current
  604.     DESCRIPTION
  605.       "Indicates the operational status of the network service
  606.        application. 'down' indicates that the network service is
  607.        not available. 'up' indicates that the network service
  608.        is operational and available.  'halted' indicates that the
  609.        service is operational but not available.  'congested'
  610.        indicates that the service is operational but no additional
  611.        inbound associations can be accomodated.  'restarting'
  612.        indicates that the service is currently unavailable but is
  613.        in the process of restarting and will be available soon.
  614.        'quiescing' indicates that service is currently operational
  615.        but is in the process of shutting down. Additional inbound
  616.        associations may be rejected by applications in the
  617.        'quiescing' state."
  618.     ::= {applEntry 6}
  619.  
  620. applLastChange OBJECT-TYPE
  621.     SYNTAX TimeStamp
  622.     MAX-ACCESS read-only
  623.     STATUS current
  624.     DESCRIPTION
  625.       "The value of sysUpTime at the time the network service
  626.        application entered its current operational state.  If
  627.        the current state was entered prior to the last
  628.        initialization of the local network management subsystem,
  629.        then this object contains a zero value."
  630.     ::= {applEntry 7}
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643. Expires May 1997                                               [Page 11]
  644.  
  645.  
  646.  
  647.  
  648.  
  649. Internet Draft      Network Services Monitoring MIB        November 1996
  650.  
  651.  
  652. applInboundAssociations OBJECT-TYPE
  653.     SYNTAX Gauge32
  654.     MAX-ACCESS read-only
  655.     STATUS current
  656.     DESCRIPTION
  657.       "The number of current associations to the network service
  658.        application, where it is the responder.  An inbound
  659.        assocation occurs when a another application successfully
  660.        connects to this one."
  661.     ::= {applEntry 8}
  662.  
  663. applOutboundAssociations OBJECT-TYPE
  664.     SYNTAX Gauge32
  665.     MAX-ACCESS read-only
  666.     STATUS current
  667.     DESCRIPTION
  668.       "The number of current associations to the network service
  669.        application, where it is the initiator.  An outbound
  670.        association occurs when this application successfully
  671.        connects to another one."
  672.     ::= {applEntry 9}
  673.  
  674. applAccumulatedInboundAssociations OBJECT-TYPE
  675.     SYNTAX Counter32
  676.     MAX-ACCESS read-only
  677.     STATUS current
  678.     DESCRIPTION
  679.       "The total number of associations to the application entity
  680.        since application initialization, where it was the responder."
  681.     ::= {applEntry 10}
  682.  
  683. applAccumulatedOutboundAssociations OBJECT-TYPE
  684.     SYNTAX Counter32
  685.     MAX-ACCESS read-only
  686.     STATUS current
  687.     DESCRIPTION
  688.       "The total number of associations to the application entity
  689.        since application initialization, where it was the initiator."
  690.     ::= {applEntry 11}
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702. Expires May 1997                                               [Page 12]
  703.  
  704.  
  705.  
  706.  
  707.  
  708. Internet Draft      Network Services Monitoring MIB        November 1996
  709.  
  710.  
  711. applLastInboundActivity OBJECT-TYPE
  712.     SYNTAX TimeStamp
  713.     MAX-ACCESS read-only
  714.     STATUS current
  715.     DESCRIPTION
  716.       "The value of sysUpTime at the time this application last
  717.        had an inbound association.  If the last association
  718.        occurred prior to the last initialization of the network
  719.        subsystem, then this object contains a zero value."
  720.     ::= {applEntry 12}
  721.  
  722. applLastOutboundActivity OBJECT-TYPE
  723.     SYNTAX TimeStamp
  724.     MAX-ACCESS read-only
  725.     STATUS current
  726.     DESCRIPTION
  727.       "The value of sysUpTime at the time this application last
  728.        had an outbound association.  If the last association
  729.        occurred prior to the last initialization of the network
  730.        subsystem, then this object contains a zero value."
  731.     ::= {applEntry 13}
  732.  
  733. applRejectedInboundAssociations OBJECT-TYPE
  734.     SYNTAX Counter32
  735.     MAX-ACCESS read-only
  736.     STATUS current
  737.     DESCRIPTION
  738.       "The total number of inbound associations the application
  739.        entity has rejected, since application initialization.
  740.        Rejected associations are not counted in the accumulated
  741.        association totals.  Note that this only counts
  742.        associations the application entity has rejected itself;
  743.        it does not count rejections that occur at lower layers
  744.        of the network.  Thus, this counter may not reflect the
  745.        true number of failed inbound associations."
  746.     ::= {applEntry 14}
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761. Expires May 1997                                               [Page 13]
  762.  
  763.  
  764.  
  765.  
  766.  
  767. Internet Draft      Network Services Monitoring MIB        November 1996
  768.  
  769.  
  770. applFailedOutboundAssociations OBJECT-TYPE
  771.     SYNTAX Counter32
  772.     MAX-ACCESS read-only
  773.     STATUS current
  774.     DESCRIPTION
  775.       "The total number associations where the application entity
  776.        is initiator and association establishment has failed,
  777.        since application initialization.  Failed associations are
  778.        not counted in the accumulated association totals."
  779.     ::= {applEntry 15}
  780.  
  781. applDescription OBJECT-TYPE
  782.     SYNTAX DisplayString
  783.     MAX-ACCESS read-only
  784.     STATUS current
  785.     DESCRIPTION
  786.       "A text description of the application.  This information
  787.        is intended to identify and briefly describe the
  788.        application in a status display."
  789.     ::= {applEntry 16}
  790.  
  791. applURL OBJECT-TYPE
  792.     SYNTAX URLString
  793.     MAX-ACCESS read-only
  794.     STATUS current
  795.     DESCRIPTION
  796.       "A URL pointing to a description of the application.
  797.        This information is intended to identify and describe
  798.        the application in a status display."
  799.     ::= {applEntry 17}
  800.  
  801.  
  802. -- The assocTable augments the information in the applTable
  803. -- with information about associations.  Note that two levels
  804. -- of compliance are specified below, depending on whether
  805. -- association monitoring is mandated.
  806.  
  807. assocTable OBJECT-TYPE
  808.     SYNTAX SEQUENCE OF AssocEntry
  809.     MAX-ACCESS not-accessible
  810.     STATUS current
  811.     DESCRIPTION
  812.         "The table holding a set of all active application
  813.          associations."
  814.     ::= {application 2}
  815.  
  816.  
  817.  
  818.  
  819.  
  820. Expires May 1997                                               [Page 14]
  821.  
  822.  
  823.  
  824.  
  825.  
  826. Internet Draft      Network Services Monitoring MIB        November 1996
  827.  
  828.  
  829. assocEntry OBJECT-TYPE
  830.     SYNTAX AssocEntry
  831.     MAX-ACCESS not-accessible
  832.     STATUS current
  833.     DESCRIPTION
  834.       "An entry associated with an association for a network
  835.        service application."
  836.     INDEX {applIndex, assocIndex}
  837.     ::= {assocTable 1}
  838.  
  839. AssocEntry ::= SEQUENCE {
  840.     assocIndex
  841.         INTEGER,
  842.     assocRemoteApplication
  843.         DisplayString,
  844.     assocApplicationProtocol
  845.         OBJECT IDENTIFIER,
  846.     assocApplicationType
  847.         INTEGER,
  848.     assocDuration
  849.         TimeStamp
  850. }
  851.  
  852. assocIndex OBJECT-TYPE
  853.     SYNTAX INTEGER (1..2147483647)
  854.     MAX-ACCESS not-accessible
  855.     STATUS current
  856.     DESCRIPTION
  857.       "An index to uniquely identify each association for a network
  858.        service application.  This attribute is the index that is
  859.        used for lexicographic ordering of the table.  Note that the
  860.        table is also indexed by the applIndex."
  861.     ::= {assocEntry 1}
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879. Expires May 1997                                               [Page 15]
  880.  
  881.  
  882.  
  883.  
  884.  
  885. Internet Draft      Network Services Monitoring MIB        November 1996
  886.  
  887.  
  888. assocRemoteApplication OBJECT-TYPE
  889.     SYNTAX DisplayString
  890.     MAX-ACCESS read-only
  891.     STATUS current
  892.     DESCRIPTION
  893.       "The name of the system running remote network service
  894.        application.  For an IP-based application this should be
  895.        either a domain name or IP address.  For an OSI application
  896.        it should be the string encoded distinguished name of the
  897.        managed object.  For X.400(1984) MTAs which do not have a
  898.        Distinguished Name, the RFC 1327 [9] syntax
  899.        'mta in globalid' should be used. Note, however, that not
  900.        all connections an MTA are necessarily to another MTA."
  901.     ::= {assocEntry 2}
  902.  
  903. assocApplicationProtocol OBJECT-TYPE
  904.     SYNTAX OBJECT IDENTIFIER
  905.     MAX-ACCESS read-only
  906.     STATUS current
  907.     DESCRIPTION
  908.       "An identification of the protocol being used for the
  909.        application.  For an OSI Application, this will be the
  910.        Application Context.  For Internet applications, the IANA
  911.        maintains a registry of the OIDs which correspond to
  912.        well-known applications.  If the application protocol is
  913.        not listed in the registry, an OID value of the form
  914.        {applTCPProtoID port} or {applUDProtoID port} are used for
  915.        TCP-based and UDP-based protocols, respectively. In either
  916.        case 'port' corresponds to the primary port number being
  917.        used by the protocol."
  918.     ::= {assocEntry 3}
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938. Expires May 1997                                               [Page 16]
  939.  
  940.  
  941.  
  942.  
  943.  
  944. Internet Draft      Network Services Monitoring MIB        November 1996
  945.  
  946.  
  947. assocApplicationType OBJECT-TYPE
  948.     SYNTAX INTEGER {
  949.         ua-initiator(1),
  950.         ua-responder(2),
  951.         peer-initiator(3),
  952.         peer-responder(4)}
  953.     MAX-ACCESS read-only
  954.     STATUS current
  955.     DESCRIPTION
  956.       "This indicates whether the remote application is some type of
  957.        client making use of this network service (e.g. a User Agent)
  958.        or a server acting as a peer. Also indicated is whether the
  959.        remote end initiated an incoming connection to the network
  960.        service or responded to an outgoing connection made by the
  961.        local application.  MTAs and messaging gateways are
  962.        considered to be peers for the purposes of this variable."
  963.     ::= {assocEntry 4}
  964.  
  965. assocDuration OBJECT-TYPE
  966.     SYNTAX TimeStamp
  967.     MAX-ACCESS read-only
  968.     STATUS current
  969.     DESCRIPTION
  970.       "The value of sysUpTime at the time this association was
  971.        started.  If this association started prior to the last
  972.        initialization of the network subsystem, then this
  973.        object contains a zero value."
  974.     ::= {assocEntry 5}
  975.  
  976.  
  977. -- Conformance information
  978.  
  979. applConformance OBJECT IDENTIFIER ::= {application 3}
  980.  
  981. applGroups      OBJECT IDENTIFIER ::= {applConformance 1}
  982. applCompliances OBJECT IDENTIFIER ::= {applConformance 2}
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997. Expires May 1997                                               [Page 17]
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003. Internet Draft      Network Services Monitoring MIB        November 1996
  1004.  
  1005.  
  1006. -- Compliance statements
  1007.  
  1008. applCompliance MODULE-COMPLIANCE
  1009.     STATUS current
  1010.     DESCRIPTION
  1011.       "The compliance statement for SNMPv2 entities
  1012.        which implement the Network Services Monitoring MIB
  1013.        for basic monitoring of network service applications."
  1014.     MODULE  -- this module
  1015.       MANDATORY-GROUPS {applGroup}
  1016.     ::= {applCompliances 1}
  1017.  
  1018. assocCompliance MODULE-COMPLIANCE
  1019.     STATUS current
  1020.     DESCRIPTION
  1021.       "The compliance statement for SNMPv2 entities which
  1022.        implement the Network Services Monitoring MIB for basic
  1023.        monitoring of network service applications and their
  1024.        associations."
  1025.     MODULE  -- this module
  1026.       MANDATORY-GROUPS {applGroup, assocGroup}
  1027.     ::= {applCompliances 2}
  1028.  
  1029.  
  1030. -- Units of conformance
  1031.  
  1032. applGroup OBJECT-GROUP
  1033.     OBJECTS {
  1034.       applName, applVersion, applUptime, applOperStatus,
  1035.       applLastChange, applInboundAssociations,
  1036.       applOutboundAssociations, applAccumulatedInboundAssociations,
  1037.       applAccumulatedOutboundAssociations, applLastInboundActivity,
  1038.       applLastOutboundActivity, applRejectedInboundAssociations,
  1039.       applFailedOutboundAssociations, applDescription, applURL}
  1040.     STATUS current
  1041.     DESCRIPTION
  1042.       "A collection of objects providing basic monitoring of
  1043.        network service applications."
  1044.     ::= {applGroups 1}
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056. Expires May 1997                                               [Page 18]
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062. Internet Draft      Network Services Monitoring MIB        November 1996
  1063.  
  1064.  
  1065. assocGroup OBJECT-GROUP
  1066.     OBJECTS {
  1067.       assocRemoteApplication, assocApplicationProtocol,
  1068.       assocApplicationType, assocDuration}
  1069.     STATUS current
  1070.     DESCRIPTION
  1071.       "A collection of objects providing basic monitoring of
  1072.        network service applications' associations."
  1073.     ::= {applGroups 2}
  1074.  
  1075.  
  1076. -- OIDs of the form {applTCPProtoID port} are intended to be used
  1077. -- for TCP-based protocols that don't have OIDs assigned by other
  1078. -- means. {applUDPProtoID port} serves the same purpose for
  1079. -- UDP-based protocols. In either case 'port' corresponds to
  1080. -- the primary port number being used by the protocol. For example,
  1081. -- assuming no other OID is assigned for SMTP, an OID of
  1082. -- {applTCPProtoID 25} could be used, since SMTP is a TCP-based
  1083. -- protocol that uses port 25 as its primary port.
  1084.  
  1085. applTCPProtoID OBJECT IDENTIFIER ::= {application 4}
  1086. applUDPProtoID OBJECT IDENTIFIER ::= {application 5}
  1087.  
  1088. END
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115. Expires May 1997                                               [Page 19]
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121. Internet Draft      Network Services Monitoring MIB        November 1996
  1122.  
  1123.  
  1124. 7.  Changes made since RFC 1565
  1125.  
  1126. The only changes made to this document since it was issued as RFC 1565
  1127. [11] are the following:
  1128.  
  1129.  (1)   applDescription and applURL fields have been added.  These fields
  1130.        are intended to identify and describe the application.
  1131.  
  1132.  (2)   A number of DESCRIPTION fields have been reworded, hopefully
  1133.        making them clearer.
  1134.  
  1135.  (3)   The new "quiescing" state has been added to applOperStatus.
  1136.  
  1137.  (4)   The prose about "dynamic single threaded processes" has been
  1138.        removed -- it was simply too confusing.
  1139.  
  1140.  (5)   Various RFC references have been updated to refer to more recent
  1141.        versions.
  1142.  
  1143.  (6)   The MIB has been renamed from APPLICATION-MIB to NETWORK-
  1144.        SERVICES-MIB.  This was done because an application MIB is now
  1145.        under development that performs very different functions from
  1146.        this MIB.
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174. Expires May 1997                                               [Page 20]
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180. Internet Draft      Network Services Monitoring MIB        November 1996
  1181.  
  1182.  
  1183. 8.  Acknowledgements
  1184.  
  1185. This document is a product of the Mail and Directory Management (MADMAN)
  1186. Working Group. It is based on an earlier MIB designed by S. Kille, T.
  1187. Lenggenhager, D. Partain, and W. Yeong.  The Electronic Mail
  1188. Association's TSC committee was instrumental in  providing feedback on
  1189. and suggesting enhancements to RFC 1565 [11] that have led to the
  1190. present document.
  1191.  
  1192.  
  1193. 9.  References
  1194.  
  1195. [1]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Structure
  1196.      of Management Information for Version 2 of the Simple Network
  1197.      Management Protocol (SNMPv2)", RFC 1902, January 1996.
  1198.  
  1199. [2]  Case, J., McCloghrie, K., Rose, M., Waldbusser, S., "Textual
  1200.      Conventions for Version 2 of the Simple Network Management Protocol
  1201.      (SNMPv2)", RFC 1903, January 1996.
  1202.  
  1203. [3]  Case, J., McCloghrie, K., Rose, M., Waldbusser, S., "Conformance
  1204.      Statements for Version 2 of the Simple Network Management Protocol
  1205.      (SNMPv2)", RFC 1904, January 1996.
  1206.  
  1207. [4]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Protocol
  1208.      Operations for Version 2 of the Simple Network Management Protocol
  1209.      (SNMPv2)", RFC 1905, January 1996.
  1210.  
  1211. [5]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Transport
  1212.      Mappings for Version 2 of the Simple Network Management Protocol
  1213.      (SNMPv2)", RFC 1906, January 1996.
  1214.  
  1215. [6]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S., "Management
  1216.      Information Base for Version 2 of the Simple Network Management
  1217.      Protocol (SNMPv2)", RFC 1907, January 1996.
  1218.  
  1219. [7]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S.,
  1220.      "Coexistence between Version 1 and Version 2 of the Internet-
  1221.      standard Network Management Framework", RFC 1908, January 1996.
  1222.  
  1223. [8]  Kille, S., "A String Representation of Distinguished Names", RFC
  1224.      1779, March 1995.
  1225.  
  1226. [9]  Kille, S., "Mapping between X.400(1988) / ISO 10021 and RFC 822",
  1227.      RFC 1327, May 1992.
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233. Expires May 1997                                               [Page 21]
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239. Internet Draft      Network Services Monitoring MIB        November 1996
  1240.  
  1241.  
  1242. [10] Berners-Lee, T., Masinter, L., McCahill, M., iform Resource
  1243.      Locators (URL)", RFC 1738, December 1994.
  1244.  
  1245. [11] Freed, N., Kille, S., "Network Services Monitoring MIB", RFC 1565,
  1246.      January 1994.
  1247.  
  1248.  
  1249. 10.  Security Considerations
  1250.  
  1251. Security issues are not discussed in this memo.
  1252.  
  1253.  
  1254. 11.  Author and Chair Addresses
  1255.  
  1256.      Ned Freed
  1257.      Innosoft International, Inc.
  1258.      1050 East Garvey Avenue South
  1259.      West Covina, CA 91790
  1260.      USA
  1261.       tel: +1 818 919 3600
  1262.       fax: +1 818 919 3614
  1263.       email: ned@innosoft.com
  1264.  
  1265.      Steve Kille, MADMAN WG Chair
  1266.      ISODE Consortium
  1267.      The Dome, The Square
  1268.      Richmond TW9 1DT
  1269.      UK
  1270.        tel: +44 181 332 9091
  1271.        email: S.Kille@isode.com
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292. Expires May 1997                                               [Page 22]
  1293.  
  1294.