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-intserv-guaranteed-mib-02.txt < prev    next >
Text File  |  1996-11-22  |  16KB  |  813 lines
  1.  
  2.  
  3.  
  4.  
  5. Internet Draft    IS Guaranteed Service MIB      November 1996
  6.  
  7.  
  8.        Integrated Services Management Information Base
  9.                 Guaranteed Service Extensions
  10.            draft-ietf-intserv-guaranteed-mib-02.txt
  11.  
  12.                  Thu Nov 21 16:08:10 PST 1996
  13.  
  14.  
  15.                           Fred Baker
  16.  
  17.                         Cisco Systems
  18.                         519 Lado Drive
  19.                Santa Barbara, California 93111
  20.  
  21.                         fred@cisco.com
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. 1.  Status of this Memo
  29.  
  30. This document is an Internet Draft.  Internet Drafts are
  31. working documents of the Internet Engineering Task Force
  32. (IETF), its Areas, and its Working Groups. Note that other
  33. groups may also distribute working documents as Internet
  34. Drafts.
  35.  
  36. Internet Drafts are draft documents valid for a maximum of six
  37. months. Internet Drafts may be updated, replaced, or obsoleted
  38. by other documents at any time.  It is not appropriate to use
  39. Internet Drafts as reference material or to cite them other
  40. than as a "working draft" or "work in progress."
  41.  
  42. Please check the I-D abstract listing contained in each
  43. Internet Draft directory to learn the current status of this
  44. or any other Internet Draft.
  45.  
  46. 2.  Abstract
  47.  
  48. This memo defines a portion of the Management Information Base
  49. (MIB) for use with network management protocols in TCP/IP-
  50. based internets.  In particular, it defines objects for
  51. managing the the interface attributes defined in the
  52. Guaranteed Service of the Integrated Services Model.  Comments
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Baker                  Expires May 1997               [Page 1]
  59.  
  60.  
  61.  
  62.  
  63. Internet Draft    IS Guaranteed Service MIB      November 1996
  64.  
  65.  
  66. should be made to the Integrated Services Working Group, int-
  67. serv@isi.edu.
  68.  
  69. This memo does not, in its draft form, specify a standard for
  70. the Internet community.
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. Baker                  Expires May 1997               [Page 2]
  117.  
  118.  
  119.  
  120.  
  121. Internet Draft    IS Guaranteed Service MIB      November 1996
  122.  
  123.  
  124. 3.  The SNMPv2 Network Management Framework
  125.  
  126. The SNMPv2 Network Management Framework consists of four major
  127. components.  They are:
  128.  
  129. o    RFC 1441 which defines the SMI, the mechanisms used for
  130.      describing and naming objects for the purpose of
  131.      management.
  132.  
  133. o    RFC 1213 defines MIB-II, the core set of managed objects
  134.      for the Internet suite of protocols.
  135.  
  136. o    RFC 1445 which defines the administrative and other
  137.      architectural aspects of the framework.
  138.  
  139. o    RFC 1448 which defines the protocol used for network
  140.      access to managed objects.
  141.  
  142. The Framework permits new objects to be defined for the
  143. purpose of experimentation and evaluation.
  144.  
  145.  
  146. 3.1.  Object Definitions
  147.  
  148. Managed objects are accessed via a virtual information store,
  149. termed the Management Information Base or MIB.  Objects in the
  150. MIB are defined using the subset of Abstract Syntax Notation
  151. One (ASN.1) defined in the SMI.  In particular, each object
  152. type is named by an OBJECT IDENTIFIER, an administratively
  153. assigned name.  The object type together with an object
  154. instance serves to uniquely identify a specific instantiation
  155. of the object.  For human convenience, we often use a textual
  156. string, termed the descriptor, to refer to the object type.
  157.  
  158.  
  159. 4.  Overview
  160.  
  161. 4.1.  Textual Conventions
  162.  
  163. Several new data types are introduced as a textual convention
  164. in this MIB document.  These textual conventions enhance the
  165. readability of the specification and can ease comparison with
  166. other specifications if appropriate.  It should be noted that
  167. the introduction of the these textual conventions has no
  168. effect on either the syntax nor the semantics of any managed
  169.  
  170.  
  171.  
  172.  
  173.  
  174. Baker                  Expires May 1997               [Page 3]
  175.  
  176.  
  177.  
  178.  
  179. Internet Draft    IS Guaranteed Service MIB      November 1996
  180.  
  181.  
  182. objects.  The use of these is merely an artifact of the
  183. explanatory method used.  Objects defined in terms of one of
  184. these methods are always encoded by means of the rules that
  185. define the primitive type.  Hence, no changes to the SMI or
  186. the SNMP are necessary to accommodate these textual
  187. conventions which are adopted merely for the convenience of
  188. readers and writers in pursuit of the elusive goal of clear,
  189. concise, and unambiguous MIB documents.
  190.  
  191. 5.  Definitions
  192.  
  193. INTEGRATED-SERVICES-GUARANTEED-MIB DEFINITIONS ::= BEGIN
  194.  
  195.     IMPORTS
  196.             MODULE-IDENTITY, OBJECT-TYPE             FROM SNMPv2-SMI
  197.             RowStatus                                FROM SNMPv2-TC
  198.             MODULE-COMPLIANCE, OBJECT-GROUP          FROM SNMPv2-CONF
  199.             intSrv                        FROM INTEGRATED-SERVICES-MIB
  200.             ifIndex                                  FROM IF-MIB;
  201.  
  202. --  This MIB module uses the extended OBJECT-TYPE macro as
  203. --  defined in [9].
  204.  
  205. intSrvGuaranteed MODULE-IDENTITY
  206.         LAST-UPDATED "9611211608Z" -- Thu Nov 21 16:08:10 PST 1996
  207.         ORGANIZATION "IETF Integrated Services Working Group"
  208.         CONTACT-INFO
  209.        "       Fred Baker
  210.        Postal: Cisco Systems
  211.                519 Lado Drive
  212.                Santa Barbara, California 93111
  213.        Tel:    +1 805 681 0115
  214.        E-Mail: fred@cisco.com"
  215.     DESCRIPTION
  216.        "The MIB module to describe the Guaranteed Service of
  217.        the Integrated Services Protocol"
  218.     ::= { intSrv 4 }
  219.  
  220. intSrvGuaranteedObjects          OBJECT IDENTIFIER ::= { intSrvGuaranteed 1 }
  221. intSrvGuaranteedNotifications    OBJECT IDENTIFIER ::= { intSrvGuaranteed 2 }
  222. intSrvGuaranteedConformance      OBJECT IDENTIFIER ::= { intSrvGuaranteed 3 }
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232. Baker                  Expires May 1997               [Page 4]
  233.  
  234.  
  235.  
  236.  
  237. Internet Draft    IS Guaranteed Service MIB      November 1996
  238.  
  239.  
  240. --      The Integrated Services Interface Attributes Database
  241. --      contains information that is shared with other reservation
  242. --      procedures such as ST-II.
  243.  
  244.  
  245.     intSrvGuaranteedIfTable OBJECT-TYPE
  246.         SYNTAX      SEQUENCE OF IntSrvGuaranteedIfEntry
  247.         MAX-ACCESS  not-accessible
  248.         STATUS      current
  249.         DESCRIPTION
  250.            "The attributes of the system's interfaces  ex-
  251.            ported by the Guaranteed Service."
  252.        ::= { intSrvGuaranteedObjects 1 }
  253.  
  254.  
  255.     intSrvGuaranteedIfEntry OBJECT-TYPE
  256.         SYNTAX      IntSrvGuaranteedIfEntry
  257.         MAX-ACCESS  not-accessible
  258.         STATUS      current
  259.         DESCRIPTION
  260.            "The reservable attributes of  a  given  inter-
  261.            face."
  262.        INDEX { ifIndex }
  263.        ::= { intSrvGuaranteedIfTable 1 }
  264.  
  265. IntSrvGuaranteedIfEntry ::=
  266.     SEQUENCE {
  267.         intSrvGuaranteedIfBacklog INTEGER,
  268.         intSrvGuaranteedIfDelay   INTEGER,
  269.         intSrvGuaranteedIfSlack   INTEGER,
  270.         intSrvGuaranteedIfStatus  RowStatus
  271.     }
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290. Baker                  Expires May 1997               [Page 5]
  291.  
  292.  
  293.  
  294.  
  295. Internet Draft    IS Guaranteed Service MIB      November 1996
  296.  
  297.  
  298.     intSrvGuaranteedIfBacklog OBJECT-TYPE
  299.         SYNTAX      INTEGER (0..'0FFFFFFF'h)
  300.         UNITS       "bytes"
  301.         MAX-ACCESS  read-create
  302.         STATUS      current
  303.         DESCRIPTION
  304.            "The Backlog  parameter  is  the  data  backlog
  305.            resulting  from  the vagaries of how a specific
  306.            implementation deviates from a  strict  bit-by-
  307.            bit  service.  So, for instance, for packetized
  308.            weighted fair queueing, Backlog is set  to  the
  309.            Maximum Packet Size.
  310.  
  311.            The Backlog term is measured in units of bytes.
  312.            An  individual  element can advertise a Backlog
  313.            value between 1 and 2**28 (a  little  over  250
  314.            megabytes)  and  the  total added over all ele-
  315.            ments can range as high as  (2**32)-1.   Should
  316.            the  sum of the different elements delay exceed
  317.            (2**32)-1, the end-to-end error term should  be
  318.            (2**32)-1."
  319.        ::= { intSrvGuaranteedIfEntry 1 }
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348. Baker                  Expires May 1997               [Page 6]
  349.  
  350.  
  351.  
  352.  
  353. Internet Draft    IS Guaranteed Service MIB      November 1996
  354.  
  355.  
  356.     intSrvGuaranteedIfDelay OBJECT-TYPE
  357.         SYNTAX      INTEGER (0..'0FFFFFFF'h)
  358.         UNITS       "microseconds"
  359.         MAX-ACCESS  read-create
  360.         STATUS      current
  361.         DESCRIPTION
  362.            "The Delay parameter at  each  service  element
  363.            should  be  set  to the maximum packet transfer
  364.            delay (independent of bucket size) through  the
  365.            service  element.   For  instance,  in a simple
  366.            router, one might compute the worst case amount
  367.            of  time  it  make  take  for a datagram to get
  368.            through the input interface to  the  processor,
  369.            and how long it would take to get from the pro-
  370.            cessor to the outbound interface (assuming  the
  371.            queueing  schemes work correctly).  For an Eth-
  372.            ernet, it might represent the worst case  delay
  373.            if  the maximum number of collisions is experi-
  374.            enced.
  375.  
  376.            The Delay term is measured in units of one  mi-
  377.            crosecond.  An individual element can advertise
  378.            a delay value between  1  and  2**28  (somewhat
  379.            over two minutes) and the total delay added all
  380.            elements  can  range  as  high  as   (2**32)-1.
  381.            Should  the sum of the different elements delay
  382.            exceed (2**32)-1, the end-to-end  delay  should
  383.            be (2**32)-1."
  384.        ::= { intSrvGuaranteedIfEntry 2 }
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406. Baker                  Expires May 1997               [Page 7]
  407.  
  408.  
  409.  
  410.  
  411. Internet Draft    IS Guaranteed Service MIB      November 1996
  412.  
  413.  
  414.     intSrvGuaranteedIfSlack OBJECT-TYPE
  415.         SYNTAX      INTEGER (0..'0FFFFFFF'h)
  416.         MAX-ACCESS  read-create
  417.         STATUS      current
  418.         DESCRIPTION
  419.            "If a network element uses a certain amount  of
  420.            slack,  Si,  to  reduce the amount of resources
  421.            that it has reserved for a particular flow,  i,
  422.            the  value  Si  should be stored at the network
  423.            element.   Subsequently,  if  reservation   re-
  424.            freshes  are  received  for flow i, the network
  425.            element must use the same slack Si without  any
  426.            further computation. This guarantees consisten-
  427.            cy in the reservation process.
  428.  
  429.            As an example for the use of  the  slack  term,
  430.            consider the case where the required end-to-end
  431.            delay, Dreq, is larger than the  maximum  delay
  432.            of the fluid flow system.  In this, Ctot is the
  433.            sum of the Backlog terms end to end,  and  Dtot
  434.            is the sum of the delay terms end to end.  Dreq
  435.            is obtained by setting R=r in the  fluid  delay
  436.            formula, and is given by
  437.  
  438.                         b/r + Ctot/r + Dtot.
  439.  
  440.            In this case the slack term is
  441.  
  442.                   S = Dreq - (b/r + Ctot/r + Dtot).
  443.  
  444.            The slack term may be used by the network  ele-
  445.            ments  to  adjust  their local reservations, so
  446.            that they can admit flows that would  otherwise
  447.            have been rejected. A service element at an in-
  448.            termediate network element that can  internally
  449.            differentiate between delay and rate guarantees
  450.            can now take advantage of this  information  to
  451.            lower the amount of resources allocated to this
  452.            flow. For example, by taking an amount of slack
  453.            s  <= S, an RCSD scheduler [5] can increase the
  454.            local delay bound, d, assigned to the flow,  to
  455.            d+s. Given an RSpec, (Rin, Sin), it would do so
  456.            by setting Rout = Rin and Sout = Sin - s.
  457.  
  458.            Similarly,  a  network  element  using  a   WFQ
  459.  
  460.  
  461.  
  462.  
  463.  
  464. Baker                  Expires May 1997               [Page 8]
  465.  
  466.  
  467.  
  468.  
  469. Internet Draft    IS Guaranteed Service MIB      November 1996
  470.  
  471.  
  472.            scheduler  can  decrease  its local reservation
  473.            from Rin to Rout by using some of the slack  in
  474.            the  RSpec.  This  can be accomplished by using
  475.            the transformation rules given in the  previous
  476.            section,  that ensure that the reduced reserva-
  477.            tion level will not increase the  overall  end-
  478.            to-end delay."
  479.        ::= { intSrvGuaranteedIfEntry 3 }
  480.  
  481.  
  482.     intSrvGuaranteedIfStatus OBJECT-TYPE
  483.         SYNTAX      RowStatus
  484.         MAX-ACCESS  read-create
  485.         STATUS      current
  486.         DESCRIPTION
  487.            "'valid' on interfaces that are configured  for
  488.            the Guaranteed Service."
  489.        ::= { intSrvGuaranteedIfEntry 4 }
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522. Baker                  Expires May 1997               [Page 9]
  523.  
  524.  
  525.  
  526.  
  527. Internet Draft    IS Guaranteed Service MIB      November 1996
  528.  
  529.  
  530. --      No notifications are currently defined
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580. Baker                  Expires May 1997              [Page 10]
  581.  
  582.  
  583.  
  584.  
  585. Internet Draft    IS Guaranteed Service MIB      November 1996
  586.  
  587.  
  588. -- conformance information
  589.  
  590.  
  591. intSrvGuaranteedGroups      OBJECT IDENTIFIER ::= { intSrvGuaranteedConformance 1 }
  592. intSrvGuaranteedCompliances OBJECT IDENTIFIER ::= { intSrvGuaranteedConformance 2 }
  593.  
  594. -- compliance statements
  595.  
  596.     intSrvGuaranteedCompliance MODULE-COMPLIANCE
  597.         STATUS  current
  598.         DESCRIPTION
  599.            "The compliance statement "
  600.        MODULE  -- this module
  601.        MANDATORY-GROUPS {
  602.            intSrvGuaranteedIfAttribGroup
  603.            }
  604.        ::= { intSrvGuaranteedCompliances 1 }
  605.  
  606.  
  607.     intSrvGuaranteedIfAttribGroup OBJECT-GROUP
  608.          OBJECTS {
  609.             intSrvGuaranteedIfBacklog,
  610.             intSrvGuaranteedIfDelay,
  611.             intSrvGuaranteedIfSlack,
  612.             intSrvGuaranteedIfStatus
  613.         }
  614.         STATUS  current
  615.         DESCRIPTION
  616.            "These objects are required  for  Systems  sup-
  617.            porting the Guaranteed Service of the Integrat-
  618.            ed Services Architecture."
  619.        ::= { intSrvGuaranteedGroups 2 }
  620.  
  621. END
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638. Baker                  Expires May 1997              [Page 11]
  639.  
  640.  
  641.  
  642.  
  643. Internet Draft    IS Guaranteed Service MIB      November 1996
  644.  
  645.  
  646. 6.  Acknowledgements
  647.  
  648. This document was produced by the Integrated Services Working
  649. Group.
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696. Baker                  Expires May 1997              [Page 12]
  697.  
  698.  
  699.  
  700.  
  701. Internet Draft    IS Guaranteed Service MIB      November 1996
  702.  
  703.  
  704. 7.  References
  705.  
  706. [1]  M.T. Rose (editor), Management Information Base for
  707.      Network Management of TCP/IP-based internets, Internet
  708.      Working Group Request for Comments 1213.  Network
  709.      Information Center, SRI International, Menlo Park,
  710.      California, (May, 1990).
  711.  
  712. [2]  Information processing systems - Open Systems
  713.      Interconnection - Specification of Abstract Syntax
  714.      Notation One (ASN.1), International Organization for
  715.      Standardization.  International Standard 8824, (December,
  716.      1987).
  717.  
  718. [3]  Information processing systems - Open Systems
  719.      Interconnection - Specification of Basic Encoding Rules
  720.      for Abstract Notation One (ASN.1), International
  721.      Organization for Standardization.  International Standard
  722.      8825, (December, 1987).
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754. Baker                  Expires May 1997              [Page 13]
  755.  
  756.  
  757.  
  758.  
  759. Internet Draft    IS Guaranteed Service MIB      November 1996
  760.  
  761.  
  762. Table of Contents
  763.  
  764.  
  765. 1 Status of this Memo ...................................    1
  766. 2 Abstract ..............................................    1
  767. 3 The SNMPv2 Network Management Framework ...............    3
  768. 3.1 Object Definitions ..................................    3
  769. 4 Overview ..............................................    3
  770. 4.1 Textual Conventions .................................    3
  771. 5 Definitions ...........................................    4
  772. 5.1 Interface Attributes Database .......................    4
  773. 5.2 Notifications .......................................    9
  774. 6 Acknowledgements ......................................   12
  775. 7 References ............................................   13
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812. Baker                  Expires May 1997              [Page 14]
  813.