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