home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_i / draft-ietf-ifmib-testmib-03.txt < prev    next >
Text File  |  1997-09-19  |  39KB  |  1,159 lines
  1.  
  2.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  3.  
  4.  
  5.                              Definitions of Managed Objects for
  6.                                 System and Interface Testing
  7.  
  8.                                          June, 1997
  9.  
  10.  
  11.                              <draft-ietf-ifmib-testmib-03.txt>
  12.  
  13.                                         Maria Greene
  14.                                         Ascom Nexion
  15.                                       greene@nexen.com
  16.  
  17.  
  18.                                       Keith McCloghrie
  19.                                        Cisco Systems
  20.                                        kzm@cisco.com
  21.  
  22.  
  23.                                          Kaj Tesink
  24.                                 Bell Communications Research
  25.                                     kaj@cc.bellcore.com
  26.  
  27.  
  28.  
  29.  
  30.  
  31.           Status of this Memo
  32.  
  33.              This document is an Internet-Draft.  Internet-Drafts are working
  34.              documents of the Internet Engineering Task Force (IETF), its Areas,
  35.              and its Working Groups.  Note that other groups may also distribute
  36.              working documents as Internet-Drafts.
  37.  
  38.              Internet-Drafts are draft documents valid for a maximum of six months
  39.              and may be updated, replaced, or obsoleted by other documents at any
  40.              time.  It is inappropriate to use Internet-Drafts as reference
  41.              material or to cite them other than as a "work in progress".
  42.  
  43.              To learn the current status of any Internet-Draft, please check the
  44.              "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow
  45.              Directories on ds.internic.net (US East Coast), nic.nordu.net
  46.              (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific
  47.              Rim).
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.           Expires December 1997                                           [Page 1]
  59.  
  60.  
  61.  
  62.  
  63.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  64.  
  65.  
  66.           Abstract
  67.  
  68.              This memo defines an experimental portion of the Management
  69.              Information Base (MIB) for use with network management protocols in
  70.              the Internet community.  In particular, it describes objects used for
  71.              testing systems and interfaces. This memo replaces the objects
  72.              originally defined in the ifTestGroup of RFC1573, the IF-MIB [6],
  73.              which have been deprecated.
  74.  
  75.              This memo specifies a MIB module in a manner that is both compliant
  76.              to the SNMPv2 SMI, and semantically identical to the peer SNMPv1
  77.              definitions.
  78.  
  79.              This memo does not specify a standard for the Internet community.
  80.  
  81.  
  82.           1.  The SNMP Network Management Framework
  83.  
  84.              The SNMP Network Management Framework presently consists of three
  85.              major components.  They are:
  86.  
  87.              o    the SMI, described in RFC 1902 [1] - the mechanisms used for
  88.                   describing and naming objects for the purpose of management.
  89.  
  90.              o    the MIB-II, STD 17, RFC 1213 [2] - the core set of managed
  91.                   objects for the Internet suite of protocols.
  92.  
  93.              o    the protocol, RFC 1157 [3] and/or RFC 1905 [4], - the protocol
  94.                   for accessing managed objects.
  95.  
  96.              The Framework permits new objects to be defined for the purpose of
  97.              experimentation and evaluation.
  98.  
  99.  
  100.  
  101.           1.1.  Object Definitions
  102.  
  103.              Managed objects are accessed via a virtual information store, termed
  104.              the Management Information Base or MIB.  Objects in the MIB are
  105.              defined using the subset of Abstract Syntax Notation One (ASN.1)
  106.              defined in the SMI.  In particular, each object type is named by an
  107.              OBJECT IDENTIFIER, an administratively assigned name.  The object
  108.              type together with an object instance serves to uniquely identify a
  109.              specific instantiation of the object.  For human convenience, we
  110.              often use a textual string, termed the descriptor, to also refer to
  111.              the object type.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.           Expires December 1997                                           [Page 2]
  120.  
  121.  
  122.  
  123.  
  124.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  125.  
  126.  
  127.           2.  Experience with the Interfaces Test Group
  128.  
  129.              The ifTestGroup of objects defined in RFC1573 has not been used
  130.              widely. Some cited problems were:
  131.  
  132.  
  133.              o    Few standard tests had been defined to date.
  134.  
  135.              o    Some well known tests had already been written on a media-
  136.                   specific basis, e.g., DS1 loopback.
  137.  
  138.              o    The ifTestGroup allowed for interface testing only.
  139.  
  140.              o    A logging capability was missing.
  141.  
  142.              As a result, the ifTestGroup and associated ifTestTable have been
  143.              deprecated. However, since renewed interest was expressed in a
  144.              generic testing capability, specifically in the development of MIBs
  145.              for managing Asynchronous Transfer Mode interfaces, a set of
  146.              requirements have been defined that form the basis for the design of
  147.              the generic Test MIB defined in this memo.
  148.  
  149.  
  150.           3.  Requirements for a Generic Test MIB
  151.  
  152.              This section describes the requirements that have been identified for
  153.              a generic test MIB.
  154.  
  155.           3.1.  Test Identification
  156.  
  157.              The system defined in RFC1573 to identify tests relies on OBJECT
  158.              IDENTIFIERs. This system is flexible in that it allows additional
  159.              tests to be defined over time and autonomously by vendors, removing
  160.              the need to register test types in a single place. This mechanism for
  161.              test identification has been retained.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.           Expires December 1997                                           [Page 3]
  181.  
  182.  
  183.  
  184.  
  185.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  186.  
  187.  
  188.           3.2.  Test Targets
  189.  
  190.              With the advent of an increasing number of non-interface related MIB
  191.              modules it is desirable to define a test capability that allows
  192.              testing of interfaces and non-interface physical entities. The
  193.              following possibilities were considered:
  194.  
  195.              a)   Separate test capabilities for interface tests and other tests.
  196.  
  197.              b)   The use of a single test capability where the test target would
  198.                   be defined within the test table.
  199.  
  200.              This memo uses the latter approach and uses an object with the syntax
  201.              RowPointer to identify test targets. (Initially, the use of the
  202.              Entity MIB was considered for identification of test targets, but
  203.              this was abandoned because this would require support of the Entity
  204.              MIB for testing purposes.)
  205.  
  206.              Tests are listed in the testTable. The entries in the testTable are
  207.              distinguished through the value of a simple integer called testIndex.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.           Expires December 1997                                           [Page 4]
  242.  
  243.  
  244.  
  245.  
  246.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  247.  
  248.  
  249.           3.3.  Logging Results
  250.  
  251.              A logging capability of test results serves to store the test results
  252.              for some period of time. Two mechanisms were considered:
  253.  
  254.              1)   Separate the test capability and the log.
  255.  
  256.              2)   Combine the test capability and the log in a single table.
  257.  
  258.              Note that searching criteria on the log relate to this choice as
  259.              well.
  260.  
  261.              The log length is necessarily limited. The following choices were
  262.              considered:
  263.  
  264.              1)   Age the entries.
  265.  
  266.              2)   Limit by the number of entries.
  267.  
  268.              3)   A system that allows either 1) or 2).
  269.  
  270.              This MIB module chooses a system where the test and logging
  271.              capability have been combined in a single table (testTable). The log
  272.              length is limited by a read-write object (testTableMaxSize).
  273.  
  274.              This MIB module also defines a notification, testComplete, which
  275.              contains the same information as the log entry. Therefore, an agent
  276.              with limited resources can limit the maximum size of the log to a
  277.              very few number of entries and rely on a management application to
  278.              receive and log the testComplete notifications.
  279.  
  280.  
  281.           3.4.  Log Searching
  282.  
  283.              Efficient searching in a log is a key to its effectiveness.  The
  284.              following possibilities were considered:
  285.  
  286.              a)   Sort on age of the entries.
  287.  
  288.              b)   Sort on test type.
  289.  
  290.              c)   Sort on combinations of the above.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.           Expires December 1997                                           [Page 5]
  303.  
  304.  
  305.  
  306.  
  307.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  308.  
  309.  
  310.              This MIB module chooses for the index testIndex, which is an integer
  311.              identifier for an invocation of a test. To obtain a new testIndex a
  312.              manager retrieves the value of testIndexNext. Each time this object
  313.              is read the next lower available value is provided. This addresses
  314.              the requests that are expected to be most common:
  315.  
  316.              o    What is the result of test (testIndex)?
  317.  
  318.              o    What are the results of the last n tests?
  319.  
  320.              Since the testIndex has been defined as decreasing, this approach
  321.              will order log entries by time, newest to oldest. The possibility of
  322.              testId wrapping is minimized by having it restart at its maximum
  323.              value and when the agent restarts. When a manager is interested in a
  324.              specific test, a specific get-request may be issued. When a manager
  325.              is interested in the latest n tests for the system, getnext/bulk
  326.              starting from (testIndex) provides the approximate answer.
  327.  
  328.  
  329.           3.5.  Determining Agent Test Capabilities
  330.  
  331.              A testCapabilitiesTable has been defined to list the tests that can
  332.              be performed through this agent.
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.           Expires December 1997                                           [Page 6]
  364.  
  365.  
  366.  
  367.  
  368.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  369.  
  370.  
  371.           4.  Definitions
  372.  
  373.                     TEST-MIB DEFINITIONS ::= BEGIN
  374.  
  375.                     IMPORTS
  376.                       MODULE-IDENTITY, OBJECT-TYPE, Unsigned32,
  377.                       experimental, NOTIFICATION-TYPE, mib-2
  378.                            FROM SNMPv2-SMI
  379.                       AutonomousType, RowPointer, TimeStamp, RowStatus
  380.                            FROM SNMPv2-TC
  381.                       MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
  382.                            FROM SNMPv2-CONF
  383.                       OwnerString
  384.                            FROM IF-MIB
  385.                       ;
  386.  
  387.                     testMIB MODULE-IDENTITY
  388.                          LAST-UPDATED "9706031200Z"
  389.                          ORGANIZATION "IETF IFMIB Working Group"
  390.                          CONTACT-INFO
  391.                             "Keith McCloghrie
  392.                              Postal:  Cisco Systems
  393.                                       170 West Tasman Drive
  394.                                       San Jose, CA 95134
  395.                                       US
  396.                              Tel:     +1 408 526 5260
  397.                              E-mail:  kzm@cisco.com
  398.  
  399.                              Kaj Tesink
  400.                              Postal:  Bell Communications Research
  401.                                       331 Newman Springs Road
  402.                                       Red Bank, NJ 07701
  403.                                       US
  404.                              Tel:     +1 908 758 5254
  405.                              E-mail:  kaj@cc.bellcore.com
  406.  
  407.                              Maria Greene
  408.                              Postal:  Ascom Nexion
  409.                                       289 Great Road
  410.  
  411.                                       Acton, MA 01720
  412.                                       US
  413.                              Tel:     +1 508 266 4570
  414.                              E-mail:  greene@nexen.com"
  415.                          DESCRIPTION
  416.                             "This MIB module provides a generic test
  417.                              capability."
  418.                     -- ********  NOTE TO THE RFC EDITOR  **************
  419.  
  420.  
  421.  
  422.  
  423.  
  424.           Expires December 1997                                           [Page 7]
  425.  
  426.  
  427.  
  428.  
  429.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  430.  
  431.  
  432.                     -- In case this module is put on the standards track
  433.                     --  replace the following:
  434.                     -- "::= {experimental XX}" with
  435.                     -- "::= { mib-2 YY }"
  436.                          ::= { experimental XX }
  437.  
  438.  
  439.                     testMIBObjects  OBJECT IDENTIFIER ::= { testMIB 1 }
  440.  
  441.                     testIndexNext  OBJECT-TYPE
  442.                                    SYNTAX         INTEGER (0..2147483647)
  443.                                    MAX-ACCESS     read-only
  444.                                    STATUS         current
  445.                                    DESCRIPTION
  446.                                     "This object contains an appropriate value to
  447.                                      be used for testIndex when creating
  448.                                      entries in the testTable.  The value
  449.                                      0 indicates that no unassigned entries are
  450.                                      available. To obtain the testIndex
  451.                                      value for a new entry, the manager issues a
  452.                                      management protocol retrieval operation to obtain
  453.                                      the current value of this object.  After each
  454.                                      retrieval, the agent should modify the value to
  455.                                      the next lower unassigned index. If the agent is
  456.                                      restarted this object shall be set to its highest value."
  457.                                    ::= { testMIBObjects 1 }
  458.  
  459.  
  460.  
  461.                     --    The Test Table
  462.  
  463.                     testTable   OBJECT-TYPE
  464.                         SYNTAX      SEQUENCE OF TestEntry
  465.                         MAX-ACCESS  not-accessible
  466.                         STATUS      current
  467.                         DESCRIPTION
  468.                                 "This table is used to initiate tests. An entry
  469.  
  470.                                 in this table corresponds to an instance of a test.
  471.                                 A test is invoked by creating a row with the
  472.                                 appropriate test attributes and using testRowStatus
  473.                                 to start a test.
  474.                                 After invoking a test,
  475.                                 the object testResult can be read to determine the
  476.                                 outcome.  If an agent can not perform the test,
  477.                                 testResult is set accordingly.  The testCode can
  478.                                 be used to provide further test-specific or entity-
  479.                                 specific (or even enterprise-specific) information
  480.  
  481.  
  482.  
  483.  
  484.  
  485.           Expires December 1997                                           [Page 8]
  486.  
  487.  
  488.  
  489.  
  490.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  491.  
  492.  
  493.                                 concerning the outcome of the test.  Only one test can
  494.                                 be in progress on each entity at any one time.  If one
  495.                                 test is in progress when another test is invoked, the
  496.                                 second test is rejected.  Some agents may reject a test
  497.                                 when a prior test is active on another entity.
  498.  
  499.                                 Before starting a test, a manager-station must first
  500.                                 obtain 'ownership' of the entry in the testTable for
  501.                                 the entity to be tested.  This is accomplished by
  502.                                 retrieving the value of testIndexNext. This value
  503.                                 entitles the manager to create a row in the testTable
  504.                                 with the value of testIndex being equal to the
  505.                                 retrieved value of testIndexNext.
  506.  
  507.                                Once ownership is obtained, the test parameters can be
  508.                                setup, and then the test is initiated by activating the
  509.                                row through testRowStatus. The agent sets the value
  510.                                of testResult to 'inProgress'.
  511.                                On completion of the test, the agent sets testResult
  512.                                and testCode in accordance with the test results and
  513.                                sets the testCompletionTime.
  514.  
  515.                                If testRowStatus is not set to active within an
  516.                                abnormally long period
  517.                                of time after ownership is obtained, the agent should
  518.                                time-out the manager, and reset the value of the
  519.                                testRowStatus object back to 'destroy'.  It is suggested
  520.                                that this time-out period be 5 minutes.
  521.  
  522.                                In general, a management station must not retransmit a
  523.                                request to invoke a test for which it does not receive a
  524.                                response; instead, it properly inspects an agent's MIB
  525.                                to determine if the invocation was successful.  Only if
  526.                                the invocation was unsuccessful, is the invocation
  527.                                request retransmitted.
  528.  
  529.  
  530.                                Some tests may require the entity to be taken off- line
  531.                                in order to execute them, or may even require the agent
  532.                                to reboot after completion of the test.  In these
  533.                                circumstances, communication with the management station
  534.                                invoking the test may be lost until after completion of
  535.                                the test.  An agent is not required to support such
  536.                                tests.  However, if such tests are supported, then the
  537.                                agent should make every effort to transmit a response to
  538.                                the request which invoked the test prior to losing
  539.                                communication.  When the agent is restored to normal
  540.                                service, the results of the test are properly made
  541.  
  542.  
  543.  
  544.  
  545.  
  546.           Expires December 1997                                           [Page 9]
  547.  
  548.  
  549.  
  550.  
  551.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  552.  
  553.  
  554.                                available in the appropriate objects.  Note that this
  555.                                requires that the testIndex value assigned to an entity
  556.                                must be unchanged even if the test causes a reboot.  An
  557.                                agent must reject any test for which it cannot, perhaps
  558.                                due to resource constraints, make available at least the
  559.                                minimum amount of information after that test
  560.                                completes."
  561.                       ::= { testMIBObjects 2 }
  562.  
  563.                   testEntry OBJECT-TYPE
  564.                       SYNTAX       TestEntry
  565.                       MAX-ACCESS   not-accessible
  566.                       STATUS       current
  567.                       DESCRIPTION
  568.                               "An entry containing objects for invoking a test."
  569.                       INDEX  { testIndex }
  570.                       ::= { testTable 1 }
  571.  
  572.                   TestEntry ::=
  573.                       SEQUENCE {
  574.                           testIndex          Unsigned32,
  575.                           testTarget         RowPointer,
  576.                           testMoreInfo       OCTET STRING,
  577.                           testType           AutonomousType,
  578.                           testCompletionTime TimeStamp,
  579.                           testResult         INTEGER,
  580.                           testCode           OBJECT IDENTIFIER,
  581.                           testOwner          OwnerString,
  582.                           testRowStatus      RowStatus }
  583.  
  584.                   testIndex      OBJECT-TYPE
  585.                       SYNTAX       Unsigned32
  586.                       MAX-ACCESS   not-accessible
  587.  
  588.                       STATUS       current
  589.                       DESCRIPTION
  590.                               "The index of this table."
  591.                      ::= { testEntry 1 }
  592.  
  593.  
  594.                testTarget     OBJECT-TYPE
  595.                    SYNTAX       RowPointer
  596.                    MAX-ACCESS   read-create
  597.                    STATUS       current
  598.                    DESCRIPTION
  599.                            "The target of the test. An example of a test target is
  600.                            an instance of an interface, identified by the OID
  601.                            'ifIndex.17'."
  602.  
  603.  
  604.  
  605.  
  606.  
  607.           Expires December 1997                                          [Page 10]
  608.  
  609.  
  610.  
  611.  
  612.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  613.  
  614.  
  615.                    DEFVAL  { { 0 0 } }
  616.                   ::= { testEntry 2 }
  617.  
  618.                testMoreInfo   OBJECT-TYPE
  619.                    SYNTAX       OCTET STRING
  620.                    MAX-ACCESS   read-create
  621.                    STATUS       current
  622.                    DESCRIPTION
  623.                            "Additional information for the test."
  624.                    DEFVAL  { "" }
  625.                   ::= { testEntry 3 }
  626.  
  627.                testType       OBJECT-TYPE
  628.                    SYNTAX       AutonomousType
  629.                    MAX-ACCESS   read-create
  630.                    STATUS       current
  631.                    DESCRIPTION
  632.                            "The identifier that specifies the test.
  633.                            OBJECT IDENTIFIER values assigned to tests
  634.                            are defined elsewhere, in association with
  635.                            specific types of entity.
  636.                            However, this document assigns a value for a full-
  637.                            duplex loopback test, and defines the special meanings
  638.                            of the subject identifier:
  639.  
  640.                              noTest  OBJECT IDENTIFIER ::= { 0 0 }
  641.  
  642.                            When the value noTest is written to this object, no
  643.                            action is taken. "
  644.                    DEFVAL  { { 0 0 } }
  645.                    ::= { testEntry 4 }
  646.  
  647.  
  648.                testCompletionTime OBJECT-TYPE
  649.                    SYNTAX        TimeStamp
  650.                    MAX-ACCESS    read-only
  651.                    STATUS        current
  652.                    DESCRIPTION
  653.                            "The value of sysUpTime when the test completed."
  654.                    ::= { testEntry 5 }
  655.  
  656.                testResult  OBJECT-TYPE
  657.                    SYNTAX       INTEGER {
  658.                                     none(1),          -- no test yet requested
  659.                                     success(2),
  660.                                     inProgress(3),
  661.                                     notSupported(4),
  662.                                     unAbleToRun(5),   -- due to state of system
  663.  
  664.  
  665.  
  666.  
  667.  
  668.           Expires December 1997                                          [Page 11]
  669.  
  670.  
  671.  
  672.  
  673.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  674.  
  675.  
  676.                                     aborted(6),
  677.                                     failed(7)
  678.                                 }
  679.                    MAX-ACCESS   read-only
  680.                    STATUS       current
  681.                    DESCRIPTION
  682.                            "This object contains the result of the most recently
  683.                            requested test, or the value 'none(1)' if no test
  684.                            has been started yet."
  685.                    DEFVAL  { none }
  686.                    ::= { testEntry 6 }
  687.  
  688.                testCode OBJECT-TYPE
  689.                    SYNTAX         OBJECT IDENTIFIER
  690.                    MAX-ACCESS     read-only
  691.                    STATUS         current
  692.                    DESCRIPTION
  693.                            "This object contains a code which contains more specific
  694.                            information on the test result, for example an error-code
  695.                            after a failed test or a result value such as round trip
  696.                            time for a 'ping' test.  Error codes and other values this
  697.                            object may take are specific to the type of entity and/or
  698.                            test.  The value may have the semantics of AutonomousType,
  699.                            InstancePointer, RowPointer or VariablePointer textual
  700.                            conventions as defined in RFC 1903.  The identifier:
  701.  
  702.                               testCodeNone  OBJECT IDENTIFIER ::= { 0 0 }
  703.  
  704.                            is defined for use if no additional result code is
  705.  
  706.                            available."
  707.                    DEFVAL  { { 0 0 } }
  708.                    ::= { testEntry 7 }
  709.  
  710.                testOwner      OBJECT-TYPE
  711.                    SYNTAX       OwnerString
  712.                    MAX-ACCESS   read-create
  713.                    STATUS       current
  714.                    DESCRIPTION
  715.                            "The manager which currently has the 'ownership'
  716.                            required to invoke a test on this entity."
  717.                    ::= { testEntry 8 }
  718.  
  719.                testRowStatus      OBJECT-TYPE
  720.                    SYNTAX       RowStatus
  721.                    MAX-ACCESS   read-create
  722.                    STATUS       current
  723.                    DESCRIPTION
  724.  
  725.  
  726.  
  727.  
  728.  
  729.           Expires December 1997                                          [Page 12]
  730.  
  731.  
  732.  
  733.  
  734.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  735.  
  736.  
  737.                            "The status of the test:
  738.                             - When the manager activates the row the test
  739.                               is started.
  740.                             - When the test is completed the row will remain
  741.                               active or may be destroyed by the manager.
  742.                             - Details of ongoing or just completed tests are
  743.                               reported in testResult and testCode.
  744.                             - A manager may abort ongoing tests or remove
  745.                               completed test information by setting the
  746.                               row status to notInService or destroy."
  747.                    DEFVAL  { active }
  748.                    ::= { testEntry 9 }
  749.  
  750.  
  751.                -- Table size
  752.  
  753.                testTableMaxSize OBJECT-TYPE
  754.                    SYNTAX        Unsigned32 (10..4294967295)
  755.                    MAX-ACCESS    read-write
  756.                    STATUS        current
  757.                    DESCRIPTION
  758.                            "The maximum number entries in the testTable.  When the
  759.                            table reaches this size the oldest entries will be discarded
  760.                            when new entries are added. The table is flushed when the
  761.                            agent is reset."
  762.                        ::= { testMIBObjects 3 }
  763.  
  764.  
  765.  
  766.                -- Test Capabilities Table
  767.  
  768.                testCapabilitiesTable   OBJECT-TYPE
  769.                    SYNTAX        SEQUENCE OF TestCapabilitiesEntry
  770.                    MAX-ACCESS    not-accessible
  771.                    STATUS        current
  772.                    DESCRIPTION
  773.                            "This table contains the test that this entity
  774.                             is able to invoke."
  775.                        ::= { testMIBObjects 4 }
  776.  
  777.                testCapabilitiesEntry    OBJECT-TYPE
  778.                    SYNTAX         TestCapabilitiesEntry
  779.                    MAX-ACCESS     not-accessible
  780.                    STATUS         current
  781.                    DESCRIPTION
  782.                            "Each entry in this table represents a test."
  783.                    INDEX { testCapabilitiesIndex }
  784.                    ::= { testCapabilitiesTable 1 }
  785.  
  786.  
  787.  
  788.  
  789.  
  790.           Expires December 1997                                          [Page 13]
  791.  
  792.  
  793.  
  794.  
  795.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  796.  
  797.  
  798.                TestCapabilitiesEntry ::=
  799.                    SEQUENCE {
  800.                        testCapabilitiesIndex            Unsigned32,
  801.                        testCapabilitiesType             AutonomousType
  802.                        }
  803.  
  804.                testCapabilitiesIndex OBJECT-TYPE
  805.                    SYNTAX        Unsigned32
  806.                    MAX-ACCESS    not-accessible
  807.                    STATUS        current
  808.                    DESCRIPTION
  809.                            "An integer index that uniquely identifies the entry."
  810.                    ::= { testCapabilitiesEntry 1 }
  811.  
  812.                testCapabilitiesType OBJECT-TYPE
  813.                    SYNTAX        AutonomousType
  814.                    MAX-ACCESS    read-only
  815.                    STATUS        current
  816.                    DESCRIPTION
  817.                            "The type of test that can be invoked."
  818.                    ::= { testCapabilitiesEntry 2 }
  819.  
  820.  
  821.  
  822.                -- Notifications
  823.  
  824.  
  825.                testMIBNotifications OBJECT IDENTIFIER ::= { testMIB 0 }
  826.  
  827.                testComplete NOTIFICATION-TYPE
  828.                    OBJECTS {
  829.                           testIndex,
  830.                           testTarget,
  831.                           testMoreInfo,
  832.                           testType,
  833.                           testResult,
  834.                           testCode,
  835.                           testOwner   }
  836.                    STATUS current
  837.                    DESCRIPTION
  838.                            "A testComplete trap signifies that a test has completed for
  839.                            a particular entity. If the testCode has the semantics of
  840.                            a VariablePointer, the variable it points at will also be
  841.                            included in the objects list."
  842.                    ::= { testMIBNotifications 1 }
  843.  
  844.  
  845.                -- Conformance Information
  846.  
  847.  
  848.  
  849.  
  850.  
  851.           Expires December 1997                                          [Page 14]
  852.  
  853.  
  854.  
  855.  
  856.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  857.  
  858.  
  859.                testMIBConformance   OBJECT IDENTIFIER ::= { testMIB 3 }
  860.  
  861.                testMIBGroups        OBJECT IDENTIFIER
  862.                                 ::= { testMIBConformance 1 }
  863.  
  864.                testMIBCompliances   OBJECT IDENTIFIER
  865.                                 ::= { testMIBConformance 2 }
  866.  
  867.  
  868.                -- Compliance Statements
  869.  
  870.                testMIBCompliance   MODULE-COMPLIANCE
  871.                     STATUS         current
  872.                     DESCRIPTION
  873.                       "The compliance statement for SNMP agents which support generic
  874.                       testing capabilities."
  875.  
  876.                     MODULE  -- this module
  877.  
  878.                     MANDATORY-GROUPS  { testMIBGroup, testNotificationGroup }
  879.  
  880.                     OBJECT      testMaxSize
  881.                     MIN-ACCESS  read-only
  882.  
  883.                     DESCRIPTION
  884.                       "Write access is not required."
  885.  
  886.                        ::= { testMIBCompliances 1 }
  887.  
  888.  
  889.                -- Units of Conformance
  890.  
  891.                testMIBGroup     OBJECT-GROUP
  892.                     OBJECTS {
  893.                        testIndexNext,
  894.                        testTarget,
  895.                        testMoreInfo,
  896.                        testType,
  897.                        testCompletionTime,
  898.                        testResult,
  899.                        testCode,
  900.                        testOwner,
  901.                        testRowStatus,
  902.                        testTableMaxSize,
  903.                        testCapabilitiesType
  904.                     }
  905.                     STATUS    current
  906.                     DESCRIPTION
  907.  
  908.  
  909.  
  910.  
  911.  
  912.           Expires December 1997                                          [Page 15]
  913.  
  914.  
  915.  
  916.  
  917.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  918.  
  919.  
  920.                       "A collection of objects providing a generic
  921.                        test capability."
  922.                   ::= { testMIBGroups 1 }
  923.  
  924.                testNotificationGroup NOTIFICATION-GROUP
  925.                    NOTIFICATIONS {
  926.                        testComplete
  927.                    }
  928.                    STATUS      current
  929.                    DESCRIPTION
  930.                       "The notifications used to indicate test completion."
  931.                   ::= { testMIBGroups 2 }
  932.  
  933.                END
  934.  
  935.  
  936.  
  937.  
  938.           5.  Acknowledgments
  939.  
  940.              This document is a product of the IETF's Interfaces MIB Working
  941.  
  942.              Group.
  943.  
  944.              The original ifTestTable was the work of Keith McCloghrie (Cisco) and
  945.              Frank Kastenholz (FTP Software) and has been used in this further
  946.              evolution.
  947.  
  948.              The authors would like to acknowledge the following individuals for
  949.              their input on requirements:
  950.  
  951.                  James Watt (Newbridge)
  952.                  Dave Fowler (Newbridge)
  953.                  Steven Buchko (Newbridge)
  954.                  Milt Rosslinsky (ACC)
  955.                  Dawn Xie (Lucent)
  956.                  Chris Martin (Netedge)
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.           Expires December 1997                                          [Page 16]
  974.  
  975.  
  976.  
  977.  
  978.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  979.  
  980.  
  981.           6.  References
  982.  
  983.           [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  984.                S. Waldbusser, "Structure of Management Information for Version 2
  985.                of the Simple Network Management Protocol (SNMPv2)", RFC1902, SNMP
  986.                Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  987.                International Network Services, January 1996.
  988.  
  989.           [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  990.                for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  991.                RFC 1213, Hughes LAN Systems, Performance Systems International,
  992.                March 1991.
  993.  
  994.           [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  995.                Management Protocol", RFC 1157, SNMP Research, Performance Systems
  996.                International, Performance Systems International, MIT Laboratory
  997.                for Computer Science, May 1990.
  998.  
  999.           [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1000.  
  1001.                S. Waldbusser, "Protocol Operations for Version 2 of the Simple
  1002.                Network Management Protocol (SNMPv2)", RFC1905, SNMP Research,Inc.,
  1003.                Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  1004.                Network Services, January 1996.
  1005.  
  1006.           [5]  McCloghrie, K., and A. Bierman, Editors, "Entity MIB", RFC2037,
  1007.                Cisco Systems, January 1996.
  1008.  
  1009.           [6]  Kastenholz, F., "Definitions of Managed Objects for the Ethernet-
  1010.                like Interface Types using SMIv2", RFC1650, FTP Software, Inc,
  1011.                August 1994.
  1012.  
  1013.           [6]  McCloghrie, K., Kastenholz, F., "Evolution of the Interfaces Group
  1014.                of MIB-II", RFC1573, (should be updated to new IF-MIB RFC#) Cisco
  1015.                Systems, Inc., FTP Software, January 1994.
  1016.  
  1017.           [7]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1018.                S. Waldbusser, "Textual Conventions for Version 2 of the Simple
  1019.                Network Management Protocol (SNMPv2)", RFC1903, SNMP Research,Inc.,
  1020.                Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  1021.                Network Services, January 1996.
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.           Expires December 1997                                          [Page 17]
  1035.  
  1036.  
  1037.  
  1038.  
  1039.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  1040.  
  1041.  
  1042.           7.  Security Considerations
  1043.  
  1044.              Security issues are not discussed in this memo.
  1045.  
  1046.           8.  Authors' Addresses
  1047.  
  1048.                             Maria Greene
  1049.                             Ascom Nexion
  1050.                             289 Great Road
  1051.                             Acton, MA 01720-4739
  1052.                             Phone: (508) 266-4570
  1053.                             EMail: greene@nexen.com
  1054.  
  1055.                             Keith McCloghrie
  1056.                             Cisco Systems
  1057.                             170 West Tasman Drive
  1058.                             San Jose, CA 95134
  1059.  
  1060.                             Phone: (408) 526-5260
  1061.                             E-mail:  kzm@cisco.com
  1062.  
  1063.                             Kaj Tesink
  1064.                             Bell Communications Research
  1065.                             Room 1A-427
  1066.                             331 Newman Springs Road
  1067.                             P.O. Box 7020
  1068.                             Red Bank, NJ  07701-7020
  1069.                             Phone: (908) 758-5254
  1070.                             EMail: kaj@cc.bellcore.com
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.           Expires December 1997                                          [Page 18]
  1096.  
  1097.  
  1098.  
  1099.  
  1100.           INTERNET-DRAFT         System/Interface Test MIB               June 1997
  1101.  
  1102.  
  1103.              Table of Contents
  1104.  
  1105.  
  1106.              1 The SNMP Network Management Framework ........................    2
  1107.              1.1 Object Definitions .........................................    2
  1108.              2 Experience with the Interfaces Test Group ....................    3
  1109.              3 Requirements for a Generic Test MIB ..........................    3
  1110.              3.1 Test Identification ........................................    3
  1111.              3.2 Test Targets ...............................................    4
  1112.              3.3 Logging Results ............................................    5
  1113.              3.4 Log Searching ..............................................    5
  1114.              3.5 Determining Agent Test Capabilities ........................    6
  1115.              4 Definitions ..................................................    7
  1116.              5 Acknowledgments ..............................................   16
  1117.              6 References ...................................................   17
  1118.  
  1119.              7 Security Considerations ......................................   18
  1120.              8 Authors' Addresses ...........................................   18
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.           Expires December 1997                                          [Page 19]
  1157.  
  1158.  
  1159.