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-02.txt < prev    next >
Text File  |  1996-12-27  |  44KB  |  1,568 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                    Definitions of Managed Objects for
  7.                       System and Interface Testing
  8.  
  9.                            December 24, 1996
  10.  
  11.  
  12.                    <draft-ietf-ifmib-testmib-02.txt>
  13.  
  14.                               Maria Greene
  15.                               Ascom Nexion
  16.                             greene@nexen.com
  17.  
  18.  
  19.                             Keith McCloghrie
  20.                              Cisco Systems
  21.                              kzm@cisco.com
  22.  
  23.  
  24.                                Kaj Tesink
  25.                       Bell Communications Research
  26.                           kaj@cc.bellcore.com
  27.  
  28.  
  29.  
  30.  
  31.  
  32. Status of this Memo
  33.  
  34.    This document is an Internet-Draft.  Internet-Drafts are working
  35.    documents of the Internet Engineering Task Force (IETF), its Areas,
  36.    and its Working Groups.  Note that other groups may also distribute
  37.    working documents as Internet-Drafts.
  38.  
  39.    Internet-Drafts are draft documents valid for a maximum of six months
  40.    and may be updated, replaced, or obsoleted by other documents at any
  41.    time.  It is inappropriate to use Internet-Drafts as reference
  42.    material or to cite them other than as a "work in progress".
  43.  
  44.    To learn the current status of any Internet-Draft, please check the
  45.    "1id-abstracts.txt" listing contained in the Internet-Drafts Shadow
  46.    Directories on ds.internic.net (US East Coast), nic.nordu.net
  47.    (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific
  48.    Rim).
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  63.  
  64.  
  65. Abstract
  66.  
  67.    This memo defines an experimental portion of the Management
  68.    Information Base (MIB) for use with network management protocols in
  69.    the Internet community.  In particular, it describes objects used for
  70.    testing systems and interfaces. This memo replaces the objects
  71.    originally defined in the ifTestGroup of RFC1573, the IF-MIB [6],
  72.    which have been deprecated.
  73.  
  74.    This memo specifies a MIB module in a manner that is both compliant
  75.    to the SNMPv2 SMI, and semantically identical to the peer SNMPv1
  76.    definitions.
  77.  
  78.    This memo does not specify a standard for the Internet community.
  79.  
  80.  
  81. 1.  The SNMP Network Management Framework
  82.  
  83.    The SNMP Network Management Framework presently consists of three
  84.    major components.  They are:
  85.  
  86.    o    the SMI, described in RFC 1902 [1] - the mechanisms used for
  87.         describing and naming objects for the purpose of management.
  88.  
  89.    o    the MIB-II, STD 17, RFC 1213 [2] - the core set of managed
  90.         objects for the Internet suite of protocols.
  91.  
  92.    o    the protocol, RFC 1157 [3] and/or RFC 1905 [4], - the protocol
  93.         for accessing managed objects.
  94.  
  95.    The Framework permits new objects to be defined for the purpose of
  96.    experimentation and evaluation.
  97.  
  98.  
  99.  
  100. 1.1.  Object Definitions
  101.  
  102.    Managed objects are accessed via a virtual information store, termed
  103.    the Management Information Base or MIB.  Objects in the MIB are
  104.    defined using the subset of Abstract Syntax Notation One (ASN.1)
  105.    defined in the SMI.  In particular, each object type is named by an
  106.    OBJECT IDENTIFIER, an administratively assigned name.  The object
  107.    type together with an object instance serves to uniquely identify a
  108.    specific instantiation of the object.  For human convenience, we
  109.    often use a textual string, termed the descriptor, to also refer to
  110.    the object type.
  111.  
  112.  
  113.  
  114.  
  115.  
  116. Expires June 1997                                         [Page 2]
  117.  
  118.  
  119.  
  120.  
  121.  
  122. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  123.  
  124.  
  125. 2.  Experience with the Interfaces Test Group
  126.  
  127.    The ifTestGroup of objects defined in RFC1573 has not been used
  128.    widely. Some cited problems were:
  129.  
  130.  
  131.    o    Few standard tests had been defined to date.
  132.  
  133.    o    Some well known tests had already been written on a media-
  134.         specific basis, e.g., DS1 loopback.
  135.  
  136.    o    The ifTestGroup allowed for interface testing only.
  137.  
  138.    o    A logging capability was missing.
  139.  
  140.    As a result, the ifTestGroup and associated ifTestTable have been
  141.    deprecated. However, since renewed interest was expressed in a
  142.    generic testing capability, specifically in the development of MIBs
  143.    for managing Asynchronous Transfer Mode interfaces, a set of
  144.    requirements have been defined that form the basis for the design of
  145.    the generic Test MIB defined in this memo.
  146.  
  147.  
  148. 3.  Requirements for a Generic Test MIB
  149.  
  150.    This section describes the requirements that have been identified for
  151.    a generic test MIB.
  152.  
  153. 3.1.  Test Identification
  154.  
  155.    The system defined in RFC1573 to identify tests relies on OBJECT
  156.    IDENTIFIERs. This system is flexible in that it allows additional
  157.    tests to be defined over time and autonomously by vendors, removing
  158.    the need to register test types in a single place. This mechanism for
  159.    test identification has been retained.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176. Expires June 1997                                         [Page 3]
  177.  
  178.  
  179.  
  180.  
  181.  
  182. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  183.  
  184.  
  185. 3.2.  Test Targets
  186.  
  187.    With the advent of an increasing number of non-interface related MIB
  188.    modules it is desirable to define a test capability that allows
  189.    testing of interfaces and non-interface physical entities. The
  190.    following possibilities were considered:
  191.  
  192.    a)   Separate test capabilities for interface tests and other tests.
  193.  
  194.    b)   The use of a single test capability where the test target would
  195.         be defined within the test table.
  196.  
  197.    This memo uses the latter approach and uses an object with the syntax
  198.    RowPointer to identify test targets. (Initially, the use of the
  199.    Entity MIB was considered for identification of test targets, but
  200.    this was abandoned because this would require support of the Entity
  201.    MIB for testing purposes.)
  202.  
  203.    Tests are listed in the testTable. The entries in the testTable are
  204.    distinguished through the value of a simple integer called testIndex.
  205.  
  206.  
  207. 3.3.  Single Versus Multiple Simultaneous Tests
  208.  
  209.    The capability of allowing multiple simultaneous tests has sometimes
  210.    been described as useful, though the requests for the feature have
  211.    been sporadic. However, when allowing for non-interface related tests
  212.    this need may become more apparent. Also, proxy situations may make
  213.    the ability to run multiple simultaneous tests more desirable. A
  214.    related question is: how long may a test run?
  215.  
  216.    This MIB module has taken a middle road approach where simultaneous
  217.    tests on different physical entities are possible, while simultaneous
  218.    tests on a single entity are excluded.  This approach avoids the need
  219.    for more complex read-create tables. A test in progress can be
  220.    stopped by setting the testType to 'noTest'.
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236. Expires June 1997                                         [Page 4]
  237.  
  238.  
  239.  
  240.  
  241.  
  242. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  243.  
  244.  
  245. 3.4.  Logging Results
  246.  
  247.    A logging capability of test results serves to store the test results
  248.    for some period of time. Two mechanisms were considered:
  249.  
  250.    1)   Separate the test capability and the log.
  251.  
  252.    2)   Combine the test capability and the log in a single table.
  253.  
  254.    Note that searching criteria on the log relate to this choice as
  255.    well.
  256.  
  257.    The log length is necessarily limited. The following choices were
  258.    considered:
  259.  
  260.    1)   Age the entries.
  261.  
  262.    2)   Limit by the number of entries.
  263.  
  264.    3)   A system that allows either 1) or 2).
  265.  
  266.    This MIB module chooses a system where the test capability
  267.    (testTable) has been separated from the log (testLogTable). The log
  268.    length is limited by a read-write object (testLogMaxSize).
  269.  
  270.    This MIB module also defines a notification, testComplete, which
  271.    contains the same information as the log entry. Therefore, an agent
  272.    with limited resources can limit the maximum size of the log to a
  273.    very few number of entries and rely on a management application to
  274.    receive and log the testComplete notifications.
  275.  
  276.  
  277. 3.5.  Log Searching
  278.  
  279.    Efficient searching in a log is a key to its effectiveness.  The
  280.    following possibilities were considered:
  281.  
  282.    a)   Sort on age of the entries.
  283.  
  284.    b)   Sort on test type.
  285.  
  286.    c)   Sort on combinations of the above.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296. Expires June 1997                                         [Page 5]
  297.  
  298.  
  299.  
  300.  
  301.  
  302. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  303.  
  304.  
  305.    This MIB module chooses for the index testId, which is an integer
  306.    identifier for an invocation of a test. This addresses the requests
  307.    that are expected to be most common:
  308.  
  309.    o    What is the result of test testId?
  310.  
  311.    o    What are the results of the last n tests?
  312.  
  313.    Since the testId has been defined as monotonically increasing, this
  314.    approach will order log entries by time, oldest to newest. The
  315.    possibility of testId wrapping is minimized by having it restart at 0
  316.    and the log flushed when the agent restarts. When a manager is
  317.    interested in a specific test, a specific get-request may be issued.
  318.    When a manager is interested in the latest n tests for the system,
  319.    getnext/bulk starting from (testId-n) provides the approximate
  320.    answer. Note that defining testId as a "TestAndDecr" would yield more
  321.    precise results because the testLogTable would then be sorted with
  322.    the most recent test first; however this was rejected because of the
  323.    counter-intuitive behavior of the resulting index and the slight
  324.    increase in complexity due to this new syntax.
  325.  
  326.  
  327. 3.6.  Determining Agent Test Capabilities
  328.  
  329.    The testTable will only have entries for those entities represented
  330.    by this agent that support tests. No capability has been defined to
  331.    list the tests that an entity is capable of. However, if an entity is
  332.    only capable of one test, then the testType columnar object for that
  333.    entity may be initialized to that type, or, if it is capable of many
  334.    tests, it may be initialized to one of the supported types.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356. Expires June 1997                                         [Page 6]
  357.  
  358.  
  359.  
  360.  
  361.  
  362. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  363.  
  364.  
  365. 4.  Definitions
  366.  
  367.      TEST-MIB DEFINITIONS ::= BEGIN
  368.  
  369.      IMPORTS
  370.        MODULE-IDENTITY, OBJECT-TYPE, TimeTicks, Unsigned32,
  371.        experimental, NOTIFICATION-TYPE, mib-2
  372.             FROM SNMPv2-SMI
  373.        TestAndIncr, AutonomousType, RowPointer
  374.             FROM SNMPv2-TC
  375.        MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
  376.             FROM SNMPv2-CONF
  377.        OwnerString
  378.             FROM IF-MIB
  379.        ;
  380.  
  381.      testMIB MODULE-IDENTITY
  382.           LAST-UPDATED "9611251200Z" -- November 25, 1996
  383.           ORGANIZATION "IETF IFMIB Working Group"
  384.           CONTACT-INFO
  385.              "Keith McCloghrie
  386.               Postal:  Cisco Systems
  387.                        170 West Tasman Drive
  388.                        San Jose, CA 95134
  389.                        US
  390.               Tel:     +1 408 526 5260
  391.               E-mail:  kzm@cisco.com
  392.  
  393.               Kaj Tesink
  394.               Postal:  Bell Communications Research
  395.                        331 Newman Springs Road
  396.                        Red Bank, NJ 07701
  397.                        US
  398.               Tel:     +1 908 758 5254
  399.               E-mail:  kaj@cc.bellcore.com
  400.  
  401.               Maria Greene
  402.               Postal:  Ascom Nexion
  403.                        289 Great Road
  404.                        Acton, MA 01720
  405.                        US
  406.               Tel:     +1 508 266 4570
  407.               E-mail:  greene@nexen.com"
  408.           DESCRIPTION
  409.              "This MIB module provides a generic test
  410.               capability."
  411.      -- ********  NOTE TO THE RFC EDITOR  **************
  412.  
  413.  
  414.  
  415.  
  416.  
  417. Expires June 1997                                         [Page 7]
  418.  
  419.  
  420.  
  421.  
  422.  
  423. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  424.  
  425.  
  426.      -- In case this module is put on the standards track
  427.      --  replace the following:
  428.      -- "::= {experimental XX}" with
  429.      -- "::= { mib-2 YY }"
  430.           ::= { experimental XX }
  431.  
  432.  
  433.      testMIBObjects  OBJECT IDENTIFIER ::= { testMIB 1 }
  434.  
  435.      --    The Test Table
  436.  
  437.      testTable   OBJECT-TYPE
  438.          SYNTAX      SEQUENCE OF TestEntry
  439.          MAX-ACCESS  not-accessible
  440.          STATUS      current
  441.          DESCRIPTION
  442.                  "This table contains one entry per entity that supports
  443.                  testing.  It defines objects which allow a network
  444.                  manager to instruct an agent to test an entity for
  445.                  various faults.  Tests for an entity are defined in the
  446.                  specific MIB for that entity.  After invoking a test,
  447.                  the object testResult can be read to determine the
  448.                  outcome.  If an agent can not perform the test,
  449.                  testResult is set to so indicate.  The testLogTable can
  450.                  be used to provide further test-specific or entity-
  451.                  specific (or even enterprise-specific) information
  452.                  concerning the outcome of the test.  Only one test can
  453.                  be in progress on each entity at any one time.  If one
  454.                  test is in progress when another test is invoked, the
  455.                  second test is rejected.  Some agents may reject a test
  456.                  when a prior test is active on another entity.
  457.  
  458.                  Before starting a test, a manager-station must first
  459.                  obtain 'ownership' of the entry in the testTable for
  460.                  the entity to be tested.  This is accomplished with the
  461.                  testId and testStatus objects as follows:
  462.  
  463.              try_again:
  464.                  get (testId, testStatus)
  465.                  while (testStatus != notInUse)
  466.                      /*
  467.                       * Loop while a test is running or some other
  468.                       * manager is configuring a test.
  469.                      */
  470.                      short delay
  471.                      get (testId, testStatus)
  472.                  }
  473.  
  474.  
  475.  
  476.  
  477.  
  478. Expires June 1997                                         [Page 8]
  479.  
  480.  
  481.  
  482.  
  483.  
  484. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  485.  
  486.  
  487.                  /*
  488.                   * Is not being used right now -- let's compete
  489.                   * to see who gets it.
  490.                   */
  491.                  lock_value = testId
  492.  
  493.                  if ( set (testId = lock_value, testStatus = inUse,
  494.                           testOwner = 'my-IP-address') == FAILURE)
  495.                      /*
  496.                       * Another manager got the testEntry -- go
  497.                       * try again
  498.                       */
  499.                      goto try_again;
  500.  
  501.                  /*
  502.                   * I have the lock
  503.                   */
  504.                  set up any test parameters.
  505.  
  506.                  /*
  507.                   * This starts the test
  508.                   */
  509.                  set (testType = test_to_run);
  510.  
  511.                  wait for test completion by polling testResult
  512.  
  513.                  when test completes, agent sets testResult
  514.                       agent also sets testStatus = 'notInUse'
  515.  
  516.                  retrieve test results from the testLog using
  517.                     lock_value as the index
  518.  
  519.                 A manager station first retrieves the value of the
  520.                 appropriate testId and testStatus objects, periodically
  521.                 repeating the retrieval if necessary, until the value of
  522.                 testStatus is 'notInUse'.  The manager station then
  523.                 tries to set the same testId object to the value it just
  524.                 retrieved, the same testStatus object to 'inUse', and
  525.                 the corresponding testOwner object to a value indicating
  526.                 itself.  If the set operation succeeds then the manager
  527.                 has obtained ownership of the testEntry, and the value
  528.                 of the testId object is incremented by the agent (per
  529.                 the semantics of TestAndIncr).  Failure of the set
  530.                 operation indicates that some other manager has obtained
  531.                 ownership of the testEntry.
  532.  
  533.                 Once ownership is obtained, any test parameters can be
  534.  
  535.  
  536.  
  537.  
  538.  
  539. Expires June 1997                                         [Page 9]
  540.  
  541.  
  542.  
  543.  
  544.  
  545. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  546.  
  547.  
  548.                 setup, and then the test is initiated by setting
  549.                 testType.  On completion of the test, the agent sets
  550.                 testStatus to 'notInUse'.  Once this occurs, the manager
  551.                 can retrieve the results.  In the (rare) event that the
  552.                 invocation of tests by two network managers were to
  553.                 overlap, then there would be a possibility that the
  554.                 first test's results might be overwritten by the second
  555.                 test's results prior to the first results being read.
  556.                 This unlikely circumstance can be detected by a network
  557.                 manager retrieving testId at the same time as retrieving
  558.                 the test results, and ensuring that the results are for
  559.                 the desired request.
  560.  
  561.                 If testType is not set within an abnormally long period
  562.                 of time after ownership is obtained, the agent should
  563.                 time-out the manager, and reset the value of the
  564.                 testStatus object back to 'notInUse'.  It is suggested
  565.                 that this time-out period be 5 minutes.
  566.  
  567.                 In general, a management station must not retransmit a
  568.                 request to invoke a test for which it does not receive a
  569.                 response; instead, it properly inspects an agent's MIB
  570.                 to determine if the invocation was successful.  Only if
  571.                 the invocation was unsuccessful, is the invocation
  572.                 request retransmitted.
  573.  
  574.                 Some tests may require the entity to be taken off- line
  575.                 in order to execute them, or may even require the agent
  576.                 to reboot after completion of the test.  In these
  577.                 circumstances, communication with the management station
  578.                 invoking the test may be lost until after completion of
  579.                 the test.  An agent is not required to support such
  580.                 tests.  However, if such tests are supported, then the
  581.                 agent should make every effort to transmit a response to
  582.                 the request which invoked the test prior to losing
  583.                 communication.  When the agent is restored to normal
  584.                 service, the results of the test are properly made
  585.                 available in the appropriate objects.  Note that this
  586.                 requires that the testIndex value assigned to an entity
  587.                 must be unchanged even if the test causes a reboot.  An
  588.                 agent must reject any test for which it cannot, perhaps
  589.                 due to resource constraints, make available at least the
  590.                 minimum amount of information after that test
  591.                 completes."
  592.        ::= { testMIBObjects 1 }
  593.  
  594.    testEntry OBJECT-TYPE
  595.  
  596.  
  597.  
  598.  
  599.  
  600. Expires June 1997                                        [Page 10]
  601.  
  602.  
  603.  
  604.  
  605.  
  606. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  607.  
  608.  
  609.        SYNTAX       TestEntry
  610.        MAX-ACCESS   not-accessible
  611.        STATUS       current
  612.        DESCRIPTION
  613.                "An entry containing objects for invoking tests on an
  614.                entity. There is one testEntry for every entity associated
  615.                with the agent that supports testing."
  616.        INDEX  { testIndex }
  617.        ::= { testTable 1 }
  618.  
  619.    TestEntry ::=
  620.        SEQUENCE {
  621.            testIndex        Unsigned32,
  622.            testTarget       RowPointer,
  623.            testId           TestAndIncr,
  624.            testStatus       INTEGER,
  625.            testType         AutonomousType,
  626.            testResult       INTEGER,
  627.            testOwner        OwnerString
  628.        }
  629.  
  630.    testIndex      OBJECT-TYPE
  631.        SYNTAX       Unsigned32
  632.        MAX-ACCESS   not-accessible
  633.        STATUS       current
  634.        DESCRIPTION
  635.                "The index of this table."
  636.       ::= { testEntry 1 }
  637.  
  638.  
  639.   testTarget     OBJECT-TYPE
  640.       SYNTAX       RowPointer
  641.       MAX-ACCESS   read-write
  642.       STATUS       current
  643.       DESCRIPTION
  644.               "The target of the test. An example of a test target is an
  645.               instance of an interface, identified by the OID
  646.               'ifIndex.17'."
  647.      ::= { testEntry 2 }
  648.  
  649.  testId         OBJECT-TYPE
  650.      SYNTAX       TestAndIncr
  651.      MAX-ACCESS   read-write
  652.      STATUS       current
  653.      DESCRIPTION
  654.              "This object identifies the current invocation of any test,
  655.              not just tests on the entity identified by the index of
  656.  
  657.  
  658.  
  659.  
  660.  
  661. Expires June 1997                                        [Page 11]
  662.  
  663.  
  664.  
  665.  
  666.  
  667. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  668.  
  669.  
  670.              this entry. If the agent is restarted the value of this
  671.              object shall be set to 0. If the value of testId ever
  672.              reaches its maximum value of 2147483647, it will latch at
  673.              that value and return the error 'inconsistentValue' (for
  674.              SNMPv2) or 'badValue' (for SNMPv1) if the manager attempts
  675.              to set it.
  676.  
  677.              Note that the value the manager sets this object to when
  678.              setting the testStatus to 'inUse(2)' is the value that
  679.              should be used for testLogIndex to retrieve the results of
  680.              the test. After a successful SET, all instances of testId
  681.              for all entries in this table will be incremented.
  682.  
  683.              The reason the testId and testStatus objects are not
  684.              outside the table is that this would limit the manager to
  685.              only running one test at a time."
  686.     ::= { testEntry 3 }
  687.  
  688. testStatus     OBJECT-TYPE
  689.     SYNTAX       INTEGER { notInUse(1), inUse(2) }
  690.     MAX-ACCESS   read-write
  691.     STATUS       current
  692.     DESCRIPTION
  693.             "This object indicates whether or not some manager currently
  694.             has the necessary 'ownership' required to invoke a test on
  695.             this entity.  A write to this object is only successful when
  696.             it changes its value from 'notInUse(1)' to 'inUse(2)'.
  697.             After completion of a test, the agent resets the value back
  698.             to 'notInUse(1)'."
  699.     ::= { testEntry 4 }
  700.  
  701. testType       OBJECT-TYPE
  702.     SYNTAX       AutonomousType
  703.     MAX-ACCESS   read-write
  704.     STATUS       current
  705.     DESCRIPTION
  706.             "A control variable used to start and stop operator-
  707.             initiated entity tests.  Most OBJECT IDENTIFIER values
  708.             assigned to tests are defined elsewhere, in association with
  709.             specific types of entity.  However, this memo defines the
  710.             special meanings of the subject identifier:
  711.  
  712.                 noTest  OBJECT IDENTIFIER ::= { 0 0 }
  713.  
  714.             When the value 'noTest' is written to this object, no action
  715.             is taken unless a test is in progress, in which case the
  716.             test is aborted.  Writing any other value to this object is
  717.  
  718.  
  719.  
  720.  
  721.  
  722. Expires June 1997                                        [Page 12]
  723.  
  724.  
  725.  
  726.  
  727.  
  728. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  729.  
  730.  
  731.             only valid when no test is currently in progress, in which
  732.             case the indicated test is initiated.
  733.  
  734.             When read, this object always returns the most recent value
  735.             that testType was set to.  If it has not been set since the
  736.             last initialization of the network management subsystem on
  737.             the agent, either a value of or a value of one of the valid
  738.             test types that can be performed on this entity is
  739.             returned."
  740.     ::= { testEntry 5 }
  741.  
  742. testResult  OBJECT-TYPE
  743.     SYNTAX       INTEGER {
  744.                      none(1),          -- no test yet requested
  745.                      success(2),
  746.                      inProgress(3),
  747.                      notSupported(4),
  748.                      unAbleToRun(5),   -- due to state of system
  749.                      aborted(6),
  750.                      failed(7)
  751.                  }
  752.     MAX-ACCESS   read-only
  753.     STATUS       current
  754.     DESCRIPTION
  755.             "This object contains the result of the most recently
  756.             requested test, or the value 'none(1)' if no tests have been
  757.             requested since the last reset."
  758.     ::= { testEntry 6 }
  759.  
  760. testOwner      OBJECT-TYPE
  761.     SYNTAX       OwnerString
  762.     MAX-ACCESS   read-write
  763.     STATUS       current
  764.     DESCRIPTION
  765.             "The manager which currently has the 'ownership'
  766.             required to invoke a test on this entity."
  767.     ::= { testEntry 7 }
  768.  
  769.  
  770. -- Log size
  771.  
  772. testLogMaxSize OBJECT-TYPE
  773.     SYNTAX        Unsigned32 (10..4294967295)
  774.     MAX-ACCESS    read-write
  775.     STATUS        current
  776.     DESCRIPTION
  777.             "The maximum number entries in the testLogTable.  When the
  778.  
  779.  
  780.  
  781.  
  782.  
  783. Expires June 1997                                        [Page 13]
  784.  
  785.  
  786.  
  787.  
  788.  
  789. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  790.  
  791.  
  792.             table reaches this size the oldest entries will be discarded
  793.             when new entries are added. The table is flushed when the
  794.             agent is reset."
  795.         ::= { testMIBObjects 2 }
  796.  
  797.  
  798.  
  799. -- Test Logging Table
  800.  
  801. testLogTable   OBJECT-TYPE
  802.     SYNTAX        SEQUENCE OF TestLogEntry
  803.     MAX-ACCESS    not-accessible
  804.     STATUS        current
  805.     DESCRIPTION
  806.             "This table contains the most recent test results for tests
  807.             which completed with the testResult of either 'success(2)'
  808.             or 'failed(7)'."
  809.         ::= { testMIBObjects 3 }
  810.  
  811. testLogEntry    OBJECT-TYPE
  812.     SYNTAX         TestLogEntry
  813.     MAX-ACCESS     not-accessible
  814.     STATUS         current
  815.     DESCRIPTION
  816.             "Each entry in this table represents a test result."
  817.     INDEX { testLogIndex }
  818.     ::= { testLogTable 1 }
  819.  
  820. TestLogEntry ::=
  821.     SEQUENCE {
  822.         testLogIndex            Unsigned32,
  823.         testLogType             AutonomousType,
  824.         testLogCompletionTime   TimeTicks,
  825.         testLogSummary          INTEGER,
  826.         testLogCode             OBJECT IDENTIFIER,
  827.         testLogOwner            OwnerString,
  828.         testLogTestIndex        Unsigned32
  829.         }
  830.  
  831. testLogIndex OBJECT-TYPE
  832.     SYNTAX        Unsigned32
  833.     MAX-ACCESS    not-accessible
  834.     STATUS        current
  835.     DESCRIPTION
  836.             "An integer index that uniquely identifies the entry in the
  837.             log. This is the value of testId for the completed test."
  838.     ::= { testLogEntry 1 }
  839.  
  840.  
  841.  
  842.  
  843.  
  844. Expires June 1997                                        [Page 14]
  845.  
  846.  
  847.  
  848.  
  849.  
  850. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  851.  
  852.  
  853. testLogType OBJECT-TYPE
  854.     SYNTAX        AutonomousType
  855.     MAX-ACCESS    read-only
  856.     STATUS        current
  857.     DESCRIPTION
  858.             "The type of test that has completed."
  859.     ::= { testLogEntry 2 }
  860.  
  861. testLogCompletionTime OBJECT-TYPE
  862.     SYNTAX        TimeTicks
  863.     MAX-ACCESS    read-only
  864.     STATUS        current
  865.     DESCRIPTION
  866.             "The value of sysUpTime when the test completed."
  867.     ::= { testLogEntry 3 }
  868.  
  869. testLogSummary OBJECT-TYPE
  870.     SYNTAX         INTEGER {
  871.                       success(2),
  872.                       failed(7)
  873.                    }
  874.     MAX-ACCESS     read-only
  875.     STATUS         current
  876.     DESCRIPTION
  877.             "The summary result of this test."
  878.     ::= { testLogEntry 4 }
  879.  
  880. testLogCode OBJECT-TYPE
  881.     SYNTAX         OBJECT IDENTIFIER
  882.     MAX-ACCESS     read-only
  883.     STATUS         current
  884.     DESCRIPTION
  885.             "This object contains a code which contains more specific
  886.             information on the test result, for example an error-code
  887.             after a failed test or a result value such as round trip
  888.             time for a 'ping' test.  Error codes and other values this
  889.             object may take are specific to the type of entity and/or
  890.             test.  The value may have the semantics of AutonomousType,
  891.             InstancePointer, RowPointer or VariablePointer textual
  892.             conventions as defined in RFC 1903.  The identifier:
  893.  
  894.                testCodeNone  OBJECT IDENTIFIER ::= { 0 0 }
  895.  
  896.             is defined for use if no additional result code is
  897.             available."
  898.     ::= { testLogEntry 5 }
  899.  
  900.  
  901.  
  902.  
  903.  
  904. Expires June 1997                                        [Page 15]
  905.  
  906.  
  907.  
  908.  
  909.  
  910. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  911.  
  912.  
  913. testLogOwner OBJECT-TYPE
  914.     SYNTAX         OwnerString
  915.     MAX-ACCESS     read-only
  916.     STATUS         current
  917.     DESCRIPTION
  918.             "The name of the manager that owned the test."
  919.     ::= { testLogEntry 6 }
  920.  
  921. testLogTestIndex OBJECT-TYPE
  922.     SYNTAX         Unsigned32
  923.     MAX-ACCESS     read-only
  924.     STATUS         current
  925.     DESCRIPTION
  926.             "The value of testIndex for this test."
  927.     ::= { testLogEntry 7 }
  928.  
  929. -- Notifications
  930.  
  931. testMIBNotifications OBJECT IDENTIFIER ::= { testMIB 0 }
  932.  
  933. testComplete NOTIFICATION-TYPE
  934.     OBJECTS {
  935.         testLogType,
  936.         testLogSummary,
  937.         testLogCode,
  938.         testLogOwner,
  939.         testLogTestIndex
  940.     }
  941.     STATUS current
  942.     DESCRIPTION
  943.             "A testComplete trap signifies that a test has completed for
  944.             a particular entity. If the testLogCode has the semantics of
  945.             a VariablePointer, the variable it points at will also be
  946.             included in the objects list."
  947.     ::= { testMIBNotifications 1 }
  948.  
  949.  
  950. -- Conformance Information
  951.  
  952. testMIBConformance   OBJECT IDENTIFIER ::= { testMIB 3 }
  953.  
  954. testMIBGroups        OBJECT IDENTIFIER
  955.                  ::= { testMIBConformance 1 }
  956.  
  957. testMIBCompliances   OBJECT IDENTIFIER
  958.                  ::= { testMIBConformance 2 }
  959.  
  960.  
  961.  
  962.  
  963.  
  964. Expires June 1997                                        [Page 16]
  965.  
  966.  
  967.  
  968.  
  969.  
  970. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  971.  
  972.  
  973. -- Compliance Statements
  974.  
  975. testMIBCompliance   MODULE-COMPLIANCE
  976.      STATUS         current
  977.      DESCRIPTION
  978.        "The compliance statement for SNMP agents which support generic
  979.        testing capabilities."
  980.  
  981.      MODULE  -- this module
  982.  
  983.      MANDATORY-GROUPS  { testMIBGroup, testNotificationGroup }
  984.  
  985.      OBJECT      testLogMaxSize
  986.      MIN-ACCESS  read-only
  987.      DESCRIPTION
  988.        "Write access is not required."
  989.  
  990.         ::= { testMIBCompliances 1 }
  991.  
  992.  
  993. -- Units of Conformance
  994.  
  995.  
  996. testMIBGroup     OBJECT-GROUP
  997.      OBJECTS {
  998.         testTarget,
  999.         testId,
  1000.         testStatus,
  1001.         testType,
  1002.         testResult,
  1003.         testOwner,
  1004.         testLogType,
  1005.         testLogMaxSize,
  1006.         testLogCompletionTime,
  1007.         testLogSummary,
  1008.         testLogCode,
  1009.         testLogOwner,
  1010.         testLogTestIndex
  1011.      }
  1012.      STATUS    current
  1013.      DESCRIPTION
  1014.        "A collection of objects providing a generic
  1015.         test capability."
  1016.    ::= { testMIBGroups 1 }
  1017.  
  1018. testNotificationGroup NOTIFICATION-GROUP
  1019.     NOTIFICATIONS {
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025. Expires June 1997                                        [Page 17]
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1032.  
  1033.  
  1034.         testComplete
  1035.     }
  1036.     STATUS      current
  1037.     DESCRIPTION
  1038.        "The notifications used to indicate test completion."
  1039.    ::= { testMIBGroups 2 }
  1040.  
  1041. END
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085. Expires June 1997                                        [Page 18]
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1092.  
  1093.  
  1094. 5.  Usage Examples
  1095.  
  1096.    The following sections show examples of interface testing and system
  1097.    testing.  These examples assume the following physical configuration
  1098.    represented using the Entity MIB [5] and that, for convenience, the
  1099.    agent uses the value of entPhysicalIndex for testIndex. Note that
  1100.    this is just a convenience for an agent that supports both the Entity
  1101.    MIB and the Test MIB and is not a requirement.
  1102.  
  1103.    A router containing two slots.  Each slot contains a 3 port
  1104.    router/bridge module. Each port is also represented in the ifTable.
  1105.  
  1106.      Physical entities -- entPhysicalTable:
  1107.        1 chassis:
  1108.          entPhysicalDescr.1 ==             "Acme Chassis Model 100"
  1109.          entPhysicalVendorType.1  ==       acmeProducts.chassisTypes.1
  1110.          entPhysicalContainedIn.1 ==       0
  1111.          entPhysicalClass.1 ==             chassis(3)
  1112.          entPhysicalParentRelPos.1 ==      0
  1113.  
  1114.        2 slots within the chassis:
  1115.          entPhysicalDescr.2 ==             "Acme Router Chassis Slot 1"
  1116.          entPhysicalVendorType.2  ==       acmeProducts.slotTypes.1
  1117.          entPhysicalContainedIn.2 ==       1
  1118.          entPhysicalClass.2 ==             container(5)
  1119.          entPhysicalParentRelPos.2 ==      1
  1120.  
  1121.          entPhysicalDescr.3 ==             "Acme Router Chassis Slot 2"
  1122.          entPhysicalVendorType.3  ==       acmeProducts.slotTypes.1
  1123.          entPhysicalContainedIn.3 ==       1
  1124.          entPhysicalClass.3 ==             container(5)
  1125.          entPhysicalParentRelPos.3 ==      2
  1126.  
  1127.        2 Field-replaceable modules:
  1128.        Slot 1 contains a module with 3 ports:
  1129.          entPhysicalDescr.4 ==             "Acme Router Module Model 10"
  1130.          entPhysicalVendorType.4  ==       acmeProducts.moduleTypes.14
  1131.          entPhysicalContainedIn.4 ==       2
  1132.          entPhysicalClass.4 ==             module(9)
  1133.          entPhysicalParentRelPos.4 ==      1
  1134.  
  1135.          entPhysicalDescr.5 ==             "Acme Router Ethernet Port 1"
  1136.          entPhysicalVendorType.5  ==       acmeProducts.portTypes.2
  1137.          entPhysicalContainedIn.5 ==       4
  1138.          entPhysicalClass.5 ==             port(10)
  1139.          entPhysicalParentRelPos.5 ==      1
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145. Expires June 1997                                        [Page 19]
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1152.  
  1153.  
  1154.          entPhysicalDescr.6 ==             "Acme Router Ethernet Port 2"
  1155.          entPhysicalVendorType.6  ==       acmeProducts.portTypes.2
  1156.          entPhysicalContainedIn.6 ==       4
  1157.          entPhysicalClass.6 ==             port(10)
  1158.          entPhysicalParentRelPos.6 ==      2
  1159.  
  1160.          entPhysicalDescr.7 ==             "Acme Router Ethernet Port 3"
  1161.          entPhysicalVendorType.7  ==       acmeProducts.portTypes.3
  1162.          entPhysicalContainedIn.7 ==       4
  1163.          entPhysicalClass.7 ==             port(10)
  1164.          entPhysicalParentRelPos.7 ==      3
  1165.  
  1166.       Slot 2 contains another 3-port module:
  1167.          entPhysicalDescr.8 ==             "Acme Router Module Model 11"
  1168.          entPhysicalVendorType.8  ==       acmeProducts.moduleTypes.15
  1169.          entPhysicalContainedIn.8 ==       3
  1170.          entPhysicalClass.8 ==             module(9)
  1171.          entPhysicalParentRelPos.8 ==      1
  1172.  
  1173.          entPhysicalDescr.9 ==             "Acme Router Fddi Port 1"
  1174.          entPhysicalVendorType.9 ==        acmeProducts.portTypes.3
  1175.          entPhysicalContainedIn.9 ==       8
  1176.          entPhysicalClass.9 ==             port(10)
  1177.          entPhysicalParentRelPos.9 ==      1
  1178.  
  1179.          entPhysicalDescr.10 ==            "Acme Router Ethernet Port 2"
  1180.          entPhysicalVendorType.10 ==       acmeProducts.portTypes.2
  1181.          entPhysicalContainedIn.10 ==      8
  1182.          entPhysicalClass.10 ==            port(10)
  1183.          entPhysicalParentRelPos.10 ==     2
  1184.  
  1185.          entPhysicalDescr.11 ==            "Acme Router Ethernet Port 3"
  1186.          entPhysicalVendorType.11 ==       acmeProducts.portTypes.2
  1187.          entPhysicalContainedIn.11 ==      8
  1188.          entPhysicalClass.11 ==            port(10)
  1189.          entPhysicalParentRelPos.11 ==     3
  1190.  
  1191.  
  1192.      Entities Supporting Tests -- testTable:
  1193.          testTarget.4 ==   entPhysicalIndex.4
  1194.          testTarget.5 ==   ifIndex.17
  1195.          testTarget.6 ==   ifIndex.18
  1196.          testTarget.7 ==   ifIndex.19
  1197.          testTarget.8 ==   entPhysicalIndex.8
  1198.          testTarget.9 ==   ifIndex.3
  1199.          testTarget.10 ==  ifIndex.4
  1200.          testTarget.11 ==  ifIndex.5
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206. Expires June 1997                                        [Page 20]
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218. 5.1.  Interface Test
  1219.  
  1220.    In this example, the network manager wishes to run a loopback test on
  1221.    the third Ethernet port on the module in slot 1. The testIndex of the
  1222.    port is 7. The Ethernet-like Interfaces MIB [6], defines an OBJECT
  1223.    IDENTIFIER for the dot3TestLoopBack.
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266. Expires June 1997                                        [Page 21]
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1273.  
  1274.  
  1275.    The test would be invoked as follow:
  1276.             try_again:
  1277.                 get (testId.7, testStatus.7)
  1278.                 while (testStatus != notInUse)
  1279.                     /*
  1280.                      * Loop while a test is running or some other
  1281.                      * manager is configuring a test.
  1282.                     */
  1283.                     short delay
  1284.                     get (testId.7, testStatus.7)
  1285.                 }
  1286.  
  1287.                 /*
  1288.                  * Is not being used right now -- let's compete
  1289.                  * to see who gets it.
  1290.                  */
  1291.                 lock_value = testId
  1292.  
  1293.                 if ( set (testId.7 = lock_value, testStatus.7 = inUse,
  1294.                          testOwner.7 = 'my-IP-address') == FAILURE)
  1295.                     /*
  1296.                      * Another manager got the testEntry -- go
  1297.                      * try again
  1298.                      */
  1299.                     goto try_again;
  1300.  
  1301.                 /*
  1302.                  * I have the lock
  1303.                  */
  1304.                 set up any test parameters.
  1305.  
  1306.                 /*
  1307.                  * This starts the test
  1308.                  */
  1309.                 set (testType.7 = dot3TestLoopBack);
  1310.  
  1311.                 wait for test completion by polling testResult.7
  1312.  
  1313.                 when test completes, agent sets testResult
  1314.                      agent also sets testStatus = 'notInUse'
  1315.  
  1316.                 retrieve any additional test results from
  1317.                    testLogTable using lock_value as the index
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326. Expires June 1997                                        [Page 22]
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1333.  
  1334.  
  1335. 5.2.  System Test
  1336.  
  1337.    A system test is the same as an interface test from the perspective
  1338.    of the test table. For example, the network administrator may wish to
  1339.    run a self test on the module in slot 2.
  1340.  
  1341.    Let's assume such a test is defined in one of the Acme vendor's
  1342.    enterprise MIBs as follows:
  1343.              acmeModuleSelfTest OBJECT-IDENTITY
  1344.                   STATUS       current
  1345.                   DESCRIPTION
  1346.                     "Run a diagnostic self-test on an Acme hardware
  1347.                     module."
  1348.                   ::= { acmeProductsTestTypes 1 }
  1349.  
  1350.    The procedure of invoking the test and retrieving the results is the
  1351.    same as that described in the Interface Test example. Note that value
  1352.    of entPhysicalIndex for the module in slot 2 is 8 based on the
  1353.    earlier example configuration so the test would be started using this
  1354.    operation:
  1355.                 /*
  1356.                  * This starts the test
  1357.                  */
  1358.                 set(testType.8 = acmeModuleSelfTest);
  1359.  
  1360. 6.  Acknowledgments
  1361.  
  1362.    This document is a product of the IETF's Interfaces MIB Working
  1363.    Group.
  1364.  
  1365.    The original ifTestTable was the work of Keith McCloghrie (Cisco) and
  1366.    Frank Kastenholz (FTP Software) and has been used almost unchanged in
  1367.    this further evolution.
  1368.  
  1369.    The authors would like to acknowledge the following individuals for
  1370.    their input on requirements:
  1371.  
  1372.        James Watt (Newbridge)
  1373.        Dave Fowler (Newbridge)
  1374.        Steven Buchko (Newbridge)
  1375.        Milt Rosslinsky (ACC)
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386. Expires June 1997                                        [Page 23]
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1393.  
  1394.  
  1395. 7.  References
  1396.  
  1397. [1]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1398.      S. Waldbusser, "Structure of Management Information for Version 2
  1399.      of the Simple Network Management Protocol (SNMPv2)", RFC1902, SNMP
  1400.      Research,Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  1401.      International Network Services, January 1996.
  1402.  
  1403. [2]  McCloghrie, K., and M. Rose, Editors, "Management Information Base
  1404.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  1405.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  1406.      March 1991.
  1407.  
  1408. [3]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  1409.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  1410.      International, Performance Systems International, MIT Laboratory
  1411.      for Computer Science, May 1990.
  1412.  
  1413. [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1414.      S. Waldbusser, "Protocol Operations for Version 2 of the Simple
  1415.      Network Management Protocol (SNMPv2)", RFC1905, SNMP Research,Inc.,
  1416.      Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  1417.      Network Services, January 1996.
  1418.  
  1419. [5]  McCloghrie, K., and A. Bierman, Editors, "Entity MIB", RFC2037,
  1420.      Cisco Systems, January 1996.
  1421.  
  1422. [6]  Kastenholz, F., "Definitions of Managed Objects for the Ethernet-
  1423.      like Interface Types using SMIv2", RFC1650, FTP Software, Inc,
  1424.      August 1994.
  1425.  
  1426. [6]  McCloghrie, K., Kastenholz, F., "Evolution of the Interfaces Group
  1427.      of MIB-II", RFC1573, (should be updated to new IF-MIB RFC#) Cisco
  1428.      Systems, Inc., FTP Software, January 1994.
  1429.  
  1430. [7]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1431.      S. Waldbusser, "Textual Conventions for Version 2 of the Simple
  1432.      Network Management Protocol (SNMPv2)", RFC1903, SNMP Research,Inc.,
  1433.      Cisco Systems, Inc., Dover Beach Consulting, Inc., International
  1434.      Network Services, January 1996.
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446. Expires June 1997                                        [Page 24]
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1453.  
  1454.  
  1455. 8.  Security Considerations
  1456.  
  1457.    Security issues are not discussed in this memo.
  1458.  
  1459. 9.  Authors' Addresses
  1460.  
  1461.                   Maria Greene
  1462.                   Ascom Nexion
  1463.                   289 Great Road
  1464.                   Acton, MA 01720-4739
  1465.                   Phone: (508) 266-4570
  1466.                   EMail: greene@nexen.com
  1467.  
  1468.                   Keith McCloghrie
  1469.                   Cisco Systems
  1470.                   170 West Tasman Drive
  1471.                   San Jose, CA 95134
  1472.                   Phone: (408) 526-5260
  1473.                   E-mail:  kzm@cisco.com
  1474.  
  1475.                   Kaj Tesink
  1476.                   Bell Communications Research
  1477.                   Room 1A-427
  1478.                   331 Newman Springs Road
  1479.                   P.O. Box 7020
  1480.                   Red Bank, NJ  07701-7020
  1481.                   Phone: (908) 758-5254
  1482.                   EMail: kaj@cc.bellcore.com
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506. Expires June 1997                                        [Page 25]
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512. INTERNET-DRAFT         System/Interface Test MIB           December 1996
  1513.  
  1514.  
  1515.    Table of Contents
  1516.  
  1517.  
  1518.    1 The SNMP Network Management Framework ........................    2
  1519.    1.1 Object Definitions .........................................    2
  1520.    2 Experience with the Interfaces Test Group ....................    3
  1521.    3 Requirements for a Generic Test MIB ..........................    3
  1522.    3.1 Test Identification ........................................    3
  1523.    3.2 Test Targets ...............................................    4
  1524.    3.3 Single Versus Multiple Simultaneous Tests ..................    4
  1525.    3.4 Logging Results ............................................    5
  1526.    3.5 Log Searching ..............................................    5
  1527.    3.6 Determining Agent Test Capabilities ........................    6
  1528.    4 Definitions ..................................................    7
  1529.    5 Usage Examples ...............................................   19
  1530.    5.1 Interface Test .............................................   21
  1531.    5.2 System Test ................................................   23
  1532.    6 Acknowledgments ..............................................   23
  1533.    7 References ...................................................   24
  1534.    8 Security Considerations ......................................   25
  1535.    9 Authors' Addresses ...........................................   25
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566. Expires June 1997                                        [Page 26]
  1567.  
  1568.