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-06.txt < prev    next >
Text File  |  1997-08-20  |  33KB  |  1,237 lines

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