home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_j_p / draft-ietf-ptopomib-pdp-00.txt < prev    next >
Text File  |  1997-08-02  |  32KB  |  1,240 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                     <draft-ietf-ptopomib-pdp-00.txt>
  9.               Physical Topology Discovery Protocol and MIB
  10.  
  11.  
  12.                               30 July 1997
  13.  
  14.  
  15.                               Andy Bierman
  16.                            Cisco Systems Inc.
  17.                            abierman@cisco.com
  18.  
  19.  
  20.                             Keith McCloghrie
  21.                            Cisco Systems Inc.
  22.                              kzm@cisco.com
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                           Status of this Memo
  29.  
  30.  
  31. This document is an Internet-Draft.  Internet-Drafts are working
  32. documents of the Internet Engineering Task Force (IETF), its areas, and
  33. its working groups.  Note that other groups may also distribute working
  34. documents as Internet-Drafts.
  35.  
  36. Internet-Drafts are draft documents valid for a maximum of six months
  37. and may be updated, replaced, or obsoleted by other documents at any
  38. time.  It is inappropriate to use Internet- Drafts as reference material
  39. or to cite them other than as ``work in progress.''
  40.  
  41. To learn the current status of any Internet-Draft, please check the
  42. ``1id-abstracts.txt'' listing contained in the Internet- Drafts Shadow
  43. Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe),
  44. ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim).
  45.  
  46.  
  47. 1.  Introduction
  48.  
  49. This memo defines an experimental protocol, and an experimental portion
  50. of the Management Information Base (MIB) for use with network management
  51. protocols in the Internet community.  In particular, it describes a
  52. physical topology discovery protocol and managed objects used for
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  65.  
  66.  
  67. managing the protocol.
  68.  
  69.  
  70. 2.  The SNMP Network Management Framework
  71.  
  72. The SNMP Network Management Framework presently consists of three major
  73. components.  They are:
  74.  
  75. o    the SMI, described in RFC 1902 [RFC1902], - the mechanisms used for
  76.      describing and naming objects for the purpose of management.
  77.  
  78. o    the MIB-II, STD 17, RFC 1213 [RFC1213], - the core set of managed
  79.      objects for the Internet suite of protocols.
  80.  
  81. o    the protocol, RFC 1157 [RFC1157] and/or RFC 1905 [RFC1905], - the
  82.      protocol for accessing managed information.
  83.  
  84.  
  85. Textual conventions are defined in RFC 1903 [RFC1903], and conformance
  86. statements are defined in RFC 1904 [RFC1904].
  87.  
  88.  
  89. The Framework permits new objects to be defined for the purpose of
  90. experimentation and evaluation.
  91.  
  92. This memo specifies a MIB module that is compliant to the SNMPv2 SMI.  A
  93. semantically identical MIB conforming to the SNMPv1 SMI can be produced
  94. through the appropriate translation.
  95.  
  96.  
  97. 2.1.  Object Definitions
  98.  
  99. Managed objects are accessed via a virtual information store, termed the
  100. Management Information Base or MIB.  Objects in the MIB are defined
  101. using the subset of Abstract Syntax Notation One (ASN.1) defined in the
  102. SMI.  In particular, each object type is named by an OBJECT IDENTIFIER,
  103. an administratively assigned name.  The object type together with an
  104. object instance serves to uniquely identify a specific instantiation of
  105. the object.  For human convenience, we often use a textual string,
  106. termed the descriptor, to refer to the object type.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117. Bierman/McCloghrie       Expires January, 1998                  [Page 2]
  118.  
  119.  
  120.  
  121.  
  122.  
  123. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  124.  
  125.  
  126. 3.  Overview
  127.  
  128. There is a need for a standardized way of representing the physical
  129. network connections pertaining to a given management domain.  A
  130. standardized discovery mechanism is also required to increase the
  131. likelihood of multi-vendor interoperability of such physical topology
  132. management information.
  133.  
  134. This document specifies a discovery protocol, suitable for use with the
  135. Physical Topolgy MIB [PTOPO].
  136.  
  137.  
  138.  
  139. 3.1.  Terms
  140.  
  141. Some terms are used throughout this document:
  142.  
  143. SNMP Agent
  144.      This term refers to an SNMP agent co-located with a particular PDP
  145.      Agent. Specifically, it refers to the SNMP Agent providing PDP MIB,
  146.      Entity MIB, Interfaces MIB, and possibly PTOPO MIB support for a
  147.      particular chassis.
  148.  
  149. PDP Agent
  150.      This term refers to a software entity which implements the PTOPO
  151.      Discovery Protocol for a particular chassis.
  152.  
  153.  
  154. 3.2.  Persistent Identifiers
  155.  
  156. The PTOPO MIB utilizes non-volatile identifiers to distinguish
  157. individual chassis and port components.  These identifiers are
  158. associated with external objects in order to relate topology information
  159. to the existing managed objects.
  160.  
  161. In particular, an object from the Entity MIB or Interfaces MIB can be
  162. used as the 'reference-point' for a connection component identifier.
  163.  
  164.  
  165. 3.3.  Relationship to the Physical Topology MIB
  166.  
  167. The Physical Topology MIB [PTOPO] allows a PDP Agent to expose learned
  168. physical topology information, using a standard MIB.  PDP is intended to
  169. fully support the PTOPO MIB.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176. Bierman/McCloghrie       Expires January, 1998                  [Page 3]
  177.  
  178.  
  179.  
  180.  
  181.  
  182. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  183.  
  184.  
  185. 3.4.  Relationship to Entity MIB
  186.  
  187. The Entity MIB [RFC2037] allows the physical component inventory and
  188. hierarchy to be identified.  The chassis identifier strings passed in
  189. PDP messages identify entPhysicalTable entries, and implementation of
  190. the entPhysicalTable and entPhysicalXTable (found in 'Entity MIB
  191. Extensions for Persistent Component Identification' [ENTITY-EXT]) are
  192. required for SNMP agents which also implement the PDP MIB.
  193.  
  194.  
  195. 3.5.  Relationship to Interfaces MIB
  196.  
  197. The Interfaces MIB provides a standard mechanism for managing network
  198. interfaces. The port identifier strings passed in PDP messages identify
  199. ifTable (or entPhysicalTable) entries, and implementation of the ifTable
  200. and ifXTable [RFC1573] are required for SNMP agents which also implement
  201. the PDP MIB, for the ports which are represented in the Interfaces MIB.
  202.  
  203.  
  204. 4.  PTOPO Discovery Protocol
  205.  
  206. This section defines a discovery protocol, suitable for supporting the
  207. data requirements of the PTOPO MIB.
  208.  
  209. The PTOPO Discovery Protocol (PDP) is a media and protocol independent
  210. protocol intended to be run on routers, bridges, access servers,
  211. switches, etc., allowing a PDP agent to learn SNMP reachability and
  212. connection endpoint information from adjacent devices.
  213.  
  214. PDP runs on various media that support Subnetwork Access Protocol
  215. (SNAP), and runs over the data-link layer only, allowing two systems
  216. running different network layer protocols can learn about each other.
  217.  
  218. Each device configured with an active PDP Agent sends periodic messages
  219. to a multicast MAC address on all physical interfaces enabled for PDP
  220. transmission, and listens for PDP messages on all operational ports.
  221. Each PDP message contains information identifying the source port as a
  222. PTOPO connection endpoint identifier. It also contains at least one
  223. network address which can be used by an NMS to reach an SNMP agent on
  224. the device (via the indicated source port).  Each PDP message contains a
  225. configurable time-to-live value, which tells the recipient PDP agent
  226. when to discard each element of learned topology information.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235. Bierman/McCloghrie       Expires January, 1998                  [Page 4]
  236.  
  237.  
  238.  
  239.  
  240.  
  241. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  242.  
  243.  
  244. 4.1.  Frame Encapsulation
  245.  
  246. A OUI value an HDLC protocol value must be chosen to identify PDP
  247. messages.  [TBD -- authority contact info on process and example]
  248.  
  249.  
  250. 4.2.  PDP Message Format
  251.  
  252. The basic PDP packet consists of a header, followed by a variable number
  253. of type/length/value (TLV) triplets, as indicated in Figure 1.
  254.  
  255.               +------------------+----------+---...--+----------+
  256.               |      header      |  TLV 1   |  ..... |   TLV N  |
  257.               +------------------+----------+---...--+----------+
  258.  
  259.                      [ Figure 1 -- Basic PDP Message Format ]
  260.  
  261.  
  262. 4.2.1.  PDP Header Format
  263.  
  264. The PDP header is a 6 byte header containing 4 fields, as shown in
  265. figure 2:
  266.  
  267.           0                   1                   2                   3
  268.           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  269.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  270.          |      Version  |     Flags     |         Time To Live          |
  271.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  272.  
  273.           0                   1
  274.           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
  275.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  276.          |          Checksum             |
  277.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  278.  
  279.                         [ figure 2 -- PDP Message Format ]
  280.  
  281.  
  282. The PDP header contains the following fields:
  283.  
  284.    - Version
  285.      The PDP protocol version number, set to 0x01 for this version of
  286.      the protocol.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294. Bierman/McCloghrie       Expires January, 1998                  [Page 5]
  295.  
  296.  
  297.  
  298.  
  299.  
  300. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  301.  
  302.  
  303.    - Flags
  304.      The PDP flags field provide for future header extensions and keep
  305.      the header word-aligned for easier processing. No flag definition
  306.      bits are defined at this time. This field must be set to zero in
  307.      all version 1 PDP messages.
  308.  
  309.    - Time to live
  310.      The number of seconds the information in this PDP message should be
  311.      regarded as valid by the recipient. Agents of the PTOPO MIB must
  312.      not return MIB information based on expired PDP messages.  The
  313.      valid range is 0 to 65535 for this field.
  314.  
  315.    - Checksum
  316.      The one's complement of the one's complement checksum of the entire
  317.      PDP message. PDP messages containing incorrect checksums must be
  318.      ignored by the recipient.
  319.  
  320.  
  321. 4.2.2.  TLV Format
  322.  
  323. Following the PDP header are a variable number of TLVs, depending on
  324. implementation and maximum message size. See figure 3 for TLV field
  325. layout.
  326.  
  327. The type field consists of the 3 byte OUI of the naming authority,
  328. followed by one byte of padding.
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353. Bierman/McCloghrie       Expires January, 1998                  [Page 6]
  354.  
  355.  
  356.  
  357.  
  358.  
  359. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  360.  
  361.  
  362. A 2 byte field follows, and contains the length, in octets, of the value
  363. field contained in the TLV.
  364.  
  365.           0                   1                   2                   3
  366.           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  367.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  368.          |                 OUI                           |    Padding    |
  369.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  370.            0                   1                   2                   3
  371.  
  372.           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  373.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  374.          |      OIU-Specific-Type        |           Length              |
  375.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  376.  
  377.           0
  378.           0 1 2 3 4 5 6 7
  379.          +-+-+-+-+-+-+-+-+
  380.          | Value byte 0  |  ... repeated through value byte[Length-1]
  381.          +-+-+-+-+-+-+-+-+
  382.  
  383.  
  384.                               [ Figure 3 - TLV Format ]
  385.  
  386. The header fields are defined as follows:
  387.  
  388. OUI  The identifier distinguishing the naming authority defining this
  389.      TLV.
  390.  
  391. Padding
  392.      A single byte, set to zero, used for alignment.
  393.  
  394. OUI-Specific-Type
  395.      The integer value identifying the type of information contained in
  396.      the value field.
  397.  
  398. Length
  399.      The length, in octets, of the value field to follow.
  400.  
  401. Value
  402.      A variable-length octet-string containing the instance-specific
  403.      information for this TLV.
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412. Bierman/McCloghrie       Expires January, 1998                  [Page 7]
  413.  
  414.  
  415.  
  416.  
  417.  
  418. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  419.  
  420.  
  421. 4.3.  Standard TLV Definitions
  422.  
  423. The standard PDP TLVs allow for a PDP agent to implement the PTOPO MIB
  424. for connections terminating on the local chassis.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471. Bierman/McCloghrie       Expires January, 1998                  [Page 8]
  472.  
  473.  
  474.  
  475.  
  476.  
  477. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  478.  
  479.  
  480. The following table summarizes the TLVs defined in this document.
  481.  
  482.    +-------+------+-----------------+--------------------------------------+
  483.    | OUI   | Type |     TLV Name    |            Example Usage             |
  484.    +-------+------+-----------------+--------------------------------------+
  485.    | IETF  |  1   | Chassis ID      | "acme.rg1000-switch.0000c07cf297"    |
  486.    +-------+------+-----------------+--------------------------------------+
  487.    | IETF  |  2   | Chassis Source  | OID string of entPhysicalAlias.11    |
  488.    +-------+------+-----------------+--------------------------------------+
  489.    | IETF  |  3   | Port ID         | "eth0/0/0"                           |
  490.    +-------+------+-----------------+--------------------------------------+
  491.    | IETF  |  4   | Port Source     | OID string of ifAlias.21             |
  492.    +-------+------+-----------------+--------------------------------------+
  493.    | IETF  |  5   | Mgmt Address    | { ipV4(1), 4, '0x01020304' }         |
  494.    +-------+------+-----------------+--------------------------------------+
  495.                          [ Figure 4 - TLV Summary ]
  496.  
  497.  
  498. 4.3.1.  Chassis ID
  499.  
  500. The Chassis ID is a mandatory TLV which identifies the chassis component
  501. of the endpoint identifier associated with the transmitting PDP agent.
  502.  
  503. It is a DisplayString, length [1..48] octets, representing the globally
  504. unique, non-volatile string identifying the chassis containing the PDP
  505. Agent.
  506.  
  507.  
  508. 4.3.2.  Chassis Source
  509.  
  510. The Chassis Source is a mandatory TLV which identifies the MIB object
  511. (implemented by the local PDP agent) which contains the chassis ID value
  512. specified in the Chassis ID TLV.
  513.  
  514. The identifier is encoded as a DisplayString, and contains an ASCII
  515. representation of the instance OID identifying the variable containing
  516. the same string as specified in the Chassis ID TLV.  For example, the
  517. instance entPhysicalAlias.19 is encoded into the value string
  518. "1.3.6.1.2.1.47.1.5.1.1.1.19", and the associated length field set to
  519. the integer value '27'.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530. Bierman/McCloghrie       Expires January, 1998                  [Page 9]
  531.  
  532.  
  533.  
  534.  
  535.  
  536. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  537.  
  538.  
  539. 4.3.3.  Port ID
  540.  
  541. The Port ID is a mandatory TLV which identifies the port component of
  542. the endpoint identifier associated with the transmitting PDP agent.  If
  543. the specified port is an IEEE 802.3 Repeater port, then this TLV is
  544. optional.
  545.  
  546. The identifier is encoded as a DisplayString, length [1..48] octets,
  547. representing the chassis-unique, non-volatile string identifying the
  548. source transmission port for this PDP message.
  549.  
  550.  
  551. 4.3.4.  Port Source
  552.  
  553. The Port Source is a mandatory TLV which identifies the MIB object
  554. (implemented by the local PDP agent) which contains the port ID value
  555. specified in the Port ID TLV. If the specified port is an IEEE 802.3
  556. Repeater port, then this TLV is optional.
  557.  
  558. The identifier is encoded as a DisplayString, and contains an ASCII
  559. representation of the instance OID identifying the variable containing
  560. the same string as specified in the Port ID TLV.  For example, the
  561. instance ifAlias.14 is encoded into the value string
  562. "1.3.6.1.2.1.31.1.1.1.18.14", and the associated length field set to the
  563. integer value '26'.
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589. Bierman/McCloghrie       Expires January, 1998                 [Page 10]
  590.  
  591.  
  592.  
  593.  
  594.  
  595. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  596.  
  597.  
  598. 4.3.5.  Management Address
  599.  
  600. The Management Address is a mandatory TLV which identifies a network
  601. address associated with the local PDP agent, which can be used to reach
  602. the agent on the port identified in the Port ID TLV.
  603.  
  604.           0                   1                   2                   3
  605.           0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
  606.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  607.          |        IANA AddressFamily     |       Address Length          |
  608.          +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  609.  
  610.           0
  611.           0 1 2 3 4 5 6 7 8 9    .....
  612.          +-+-+-+-+-+-+-+-+-+-+-+  ... -+-+-+-+-+-+-+-+-+-+
  613.          | Addr byte 1   |        ...    | Addr byte N   |
  614.          +-+-+-+-+-+-+-+-+-+-+-+ .....-+-+-+-+-+-+-+-+-+-+
  615.  
  616.                    [ Figure 5 -- Management Address TLV Format ]
  617.  
  618. The Management Address fields are defined as follows:
  619.  
  620. IANA Address Family
  621.      The enumerated value for the network address type identified in
  622.      this TLV.
  623.  
  624. Address Length
  625.      The number of octets contained in the address string to follow.
  626.  
  627. Address
  628.      The binary string containing the network management address for
  629.      this TLV.
  630.  
  631.  
  632. 4.4.  Protocol Operation
  633.  
  634. An active PDP Agent must transmit PDP messages, process received PDP
  635. messages, and maintain an instance of the PTOPO MIB containing the
  636. information learned from received PDP messages.
  637.  
  638. During processing of received PDP messages, a PDP Agent must skip and
  639. ignore TLVs unknown to the agent.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648. Bierman/McCloghrie       Expires January, 1998                 [Page 11]
  649.  
  650.  
  651.  
  652.  
  653.  
  654. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  655.  
  656.  
  657. 4.4.1.  Message Transmission
  658.  
  659. An active PDP agent must transmit a PDP message out each interface
  660. configured for PDP transmission, once each time interval specified in
  661. the pdpMessageTxInterval MIB object.  Actual transmission intervals are
  662. jittered to prevent synchronization effects.  Each message is sent with
  663. a time-to-live field equal to the value of pdpMessageTxHoldTime MIB
  664. object, and must contain at least the five mandatory IETF TLVs
  665. supporting the PTOPO MIB.  Additional proprietary TLVs may be added, as
  666. maximum frame size permits.
  667.  
  668.  
  669. 4.4.2.  Message Processing
  670.  
  671. Upon reception of a PDP message, and verifying the message checksum to
  672. be correct, the TLV information is extracted, and relevant PTOPO MIB
  673. information is updated.  If an entry is added, deleted, or modified, the
  674. appropriate TimeFilter and last change time internal variables should be
  675. updated to signal the change to an NMS.
  676.  
  677.  
  678. 4.4.3.  Interface Shutdown Procedure
  679.  
  680. In the event an interface, currently configured with PDP message
  681. transmission enabled, either becomes disabled, or the interface is
  682. administratively disabled, a final PDP message is transmitted with a
  683. time to live value of zero.  After reception of such a PDP message, the
  684. PDP Agent must remove information in the PTOPO MIB associated with the
  685. indicated connection endpoint.
  686.  
  687.  
  688.  
  689. 5.  PTOPO Discovery Protocol MIB
  690.  
  691. This section defines the MIB used to configure PDP agent behavior.
  692.  
  693.  
  694. 5.1.  PDP MIB Definitions
  695.  
  696. PDP-MIB DEFINITIONS ::= BEGIN
  697.  
  698. IMPORTS
  699.     MODULE-IDENTITY, OBJECT-TYPE, Integer32
  700.         FROM SNMPv2-SMI
  701.     RowStatus
  702.  
  703.  
  704.  
  705.  
  706.  
  707. Bierman/McCloghrie       Expires January, 1998                 [Page 12]
  708.  
  709.  
  710.  
  711.  
  712.  
  713. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  714.  
  715.  
  716.         FROM SNMPv2-TC
  717.     MODULE-COMPLIANCE, OBJECT-GROUP
  718.         FROM SNMPv2-CONF
  719.     PhysicalIndex
  720.         FROM ENTITY-MIB;
  721.  
  722. pdpMIB MODULE-IDENTITY
  723.     LAST-UPDATED "9707300000Z"
  724.     ORGANIZATION "Cisco Systems, Inc."
  725.     CONTACT-INFO
  726.                      "Andy Bierman
  727.                      Cisco Systems Inc.
  728.                      170 West Tasman Drive
  729.                      San Jose, CA 95134
  730.                      408-527-3711
  731.                      abierman@cisco.com
  732.  
  733.                      Keith McCloghrie
  734.                      Cisco Systems Inc.
  735.                      170 West Tasman Drive
  736.                      San Jose, CA 95134
  737.                      408-526-5260
  738.                      kzm@cisco.com"
  739.     DESCRIPTION
  740.             "The MIB module for managing the Physical Topology Discovery
  741.             Protocol."
  742.     ::= { experimental xx }
  743.  
  744. pdpMIBObjects   OBJECT IDENTIFIER ::= { pdpMIB 1 }
  745.  
  746. -- MIB groups
  747. pdpConfig    OBJECT IDENTIFIER ::= { pdpMIBObjects 1 }
  748.  
  749. --
  750. --  ***********************************************************
  751. --
  752. --           P T O P O    P D P    C O N F I G
  753. --
  754. --  ***********************************************************
  755. --
  756. --   The Physical Topology Discovery Protocol Configuration Group
  757.  
  758. pdpAdminStatus OBJECT-TYPE
  759.     SYNTAX      INTEGER  {
  760.                         enabled(1),
  761.  
  762.  
  763.  
  764.  
  765.  
  766. Bierman/McCloghrie       Expires January, 1998                 [Page 13]
  767.  
  768.  
  769.  
  770.  
  771.  
  772. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  773.  
  774.  
  775.                         disabled(2)
  776.                 }
  777.     MAX-ACCESS  read-write
  778.     STATUS      current
  779.     DESCRIPTION
  780.             "The administratively desired status of the physical
  781.             topology discovery protocol.
  782.  
  783.             If the agent is capable of storing non-volatile
  784.             configuration, then the value of this object must be
  785.             restored after a re-initialization of the management
  786.             system."
  787.     ::= { pdpConfig 1 }
  788.  
  789. pdpOperStatus OBJECT-TYPE
  790.     SYNTAX      INTEGER  {
  791.                         enabled(1),
  792.                         disabled(2)
  793.                 }
  794.     MAX-ACCESS  read-only
  795.     STATUS      current
  796.     DESCRIPTION
  797.             "The current operational status of the physical topology
  798.             discovery protocol."
  799.     ::= { pdpConfig 2 }
  800.  
  801. pdpMessageTxInterval OBJECT-TYPE
  802.     SYNTAX      Integer32 (5..32768)
  803.     UNITS       "seconds"
  804.     MAX-ACCESS  read-write
  805.     STATUS      current
  806.     DESCRIPTION
  807.             "The interval at which PDP advertisements are transmitted on
  808.             behalf of this agent.
  809.  
  810.             If the agent is capable of storing non-volatile
  811.             configuration, then the value of this object must be
  812.             restored after a re-initialization of the management
  813.             system."
  814.     DEFVAL       { 60 }
  815.     ::= { pdpConfig 3 }
  816.  
  817. pdpMessageTxHoldTime OBJECT-TYPE
  818.     SYNTAX      Integer32 (10..65535)
  819.     UNITS       "seconds"
  820.  
  821.  
  822.  
  823.  
  824.  
  825. Bierman/McCloghrie       Expires January, 1998                 [Page 14]
  826.  
  827.  
  828.  
  829.  
  830.  
  831. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  832.  
  833.  
  834.     MAX-ACCESS  read-write
  835.     STATUS      current
  836.     DESCRIPTION
  837.             "The time-to-live value used in PDP advertisements
  838.             transmitted on behalf of this agent.
  839.  
  840.             If the agent is capable of storing non-volatile
  841.             configuration, then the value of this object must be
  842.             restored after a re-initialization of the management
  843.             system."
  844.     DEFVAL        { 180 }
  845.     ::= { pdpConfig 4 }
  846.  
  847. pdpTxSuppressTable   OBJECT-TYPE
  848.     SYNTAX      SEQUENCE OF PdpTxSuppressEntry
  849.     MAX-ACCESS  not-accessible
  850.     STATUS      current
  851.     DESCRIPTION
  852.             "A table controlling PDP advertisement transmission on
  853.             individual ports."
  854.     ::= { pdpConfig 5 }
  855.  
  856. pdpTxSuppressEntry   OBJECT-TYPE
  857.     SYNTAX      PdpTxSuppressEntry
  858.     MAX-ACCESS  not-accessible
  859.     STATUS      current
  860.     DESCRIPTION
  861.             "PDP advertisement transmission configuration information
  862.             for a particular port.  The port must be contained in the
  863.             same chassis as the PDP agent. PDP advertisements will not
  864.             be transmitted on this port, even if the port is enabled.
  865.  
  866.             If the agent is capable of storing non-volatile
  867.             configuration, then each active pdpTxSuppressEntry must be
  868.             re-created after a re-initialization of the management
  869.             system.
  870.  
  871.             Only entries pertaining to the 'local' chassis may be
  872.             created in this table."
  873.     INDEX  {
  874.         pdpTxSuppressChassisId,
  875.         pdpTxSuppressPortId
  876.     }
  877.     ::= { pdpTxSuppressTable 1 }
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884. Bierman/McCloghrie       Expires January, 1998                 [Page 15]
  885.  
  886.  
  887.  
  888.  
  889.  
  890. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  891.  
  892.  
  893. PdpTxSuppressEntry ::= SEQUENCE {
  894.       pdpTxSuppressChassisId       PhysicalIndex,
  895.       pdpTxSuppressPortId          PhysicalIndex,
  896.       pdpTxSuppressRowStatus       RowStatus
  897. }
  898.  
  899. pdpTxSuppressChassisId  OBJECT-TYPE
  900.     SYNTAX      PhysicalIndex
  901.     MAX-ACCESS  not-accessible
  902.     STATUS      current
  903.     DESCRIPTION
  904.             "The entPhysicalIndex value used to identify the chassis
  905.             component associated with this entry."
  906.     ::= { pdpTxSuppressEntry 1 }
  907.  
  908. pdpTxSuppressPortId    OBJECT-TYPE
  909.     SYNTAX      PhysicalIndex
  910.     MAX-ACCESS  not-accessible
  911.     STATUS      current
  912.     DESCRIPTION
  913.             "The entPhysicalIndex value used to identify the port
  914.             component associated with this entry."
  915.     ::= { pdpTxSuppressEntry 2 }
  916.  
  917. pdpTxSuppressRowStatus  OBJECT-TYPE
  918.     SYNTAX        RowStatus
  919.     MAX-ACCESS    read-create
  920.     STATUS        current
  921.     DESCRIPTION
  922.             "The status of this entry."
  923.     ::= { pdpTxSuppressEntry 3 }
  924.  
  925.  
  926. -- conformance information
  927. pdpConformance OBJECT IDENTIFIER ::= { pdpMIB 2 }
  928.  
  929. pdpCompliances OBJECT IDENTIFIER ::= { pdpConformance 1 }
  930. pdpGroups      OBJECT IDENTIFIER ::= { pdpConformance 2 }
  931.  
  932. -- compliance statements
  933.  
  934. pdpCompliance MODULE-COMPLIANCE
  935.    STATUS  current
  936.     DESCRIPTION
  937.             "The compliance statement for SNMP entities which implement
  938.  
  939.  
  940.  
  941.  
  942.  
  943. Bierman/McCloghrie       Expires January, 1998                 [Page 16]
  944.  
  945.  
  946.  
  947.  
  948.  
  949. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  950.  
  951.  
  952.             the PDP MIB."
  953.     MODULE  -- this module
  954.         MANDATORY-GROUPS { pdpConfigGroup }
  955.  
  956.     ::= { pdpCompliances 1 }
  957.  
  958. -- MIB groupings
  959.  
  960. pdpConfigGroup    OBJECT-GROUP
  961.     OBJECTS {
  962.         pdpAdminStatus,
  963.         pdpOperStatus,
  964.         pdpMessageTxInterval,
  965.         pdpMessageTxHoldTime,
  966.         pdpTxSuppressRowStatus
  967.     }
  968.     STATUS  current
  969.     DESCRIPTION
  970.             "The collection of objects which are used to configure the
  971.             PTOPO Discovery Protocol implementation behavior.
  972.  
  973.             This group is mandatory for agents which implement the PTOPO
  974.             Discovery Protocol."
  975.     ::= { pdpGroups 1 }
  976.  
  977. END
  978.  
  979.  
  980. 6.  Acknowledgements
  981.  
  982. The PTOPO Discovery Protocol is based on the Cisco Discovery Ptotocol.
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002. Bierman/McCloghrie       Expires January, 1998                 [Page 17]
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  1009.  
  1010.  
  1011. 7.  References
  1012.  
  1013. [ENTITY-EXT]
  1014.      Bierman, A., McCloghrie, K., "Entity MIB Extensions for Persistent
  1015.      Component Identification", draft-bierman-entmib-compid-00.txt,
  1016.      Cisco Systems, July 1997.
  1017.  
  1018. [PTOPO]
  1019.      Bierman, A., Kones, K., "Physical Topology MIB", draft-ietf-
  1020.      ptopomib-mib-00.txt, Cisco Systems, Bay Networks, July 1997.
  1021.  
  1022. [RFC1157]
  1023.      Case, J., M. Fedor, M. Schoffstall, J. Davin, "Simple Network
  1024.      Management Protocol", RFC 1157, SNMP Research, Performance Systems
  1025.      International, MIT Laboratory for Computer Science, May 1990.
  1026.  
  1027. [RFC1213]
  1028.      McCloghrie, K., and M. Rose, Editors, "Management Information Base
  1029.      for Network Management of TCP/IP-based internets: MIB-II", STD 17,
  1030.      RFC 1213, Hughes LAN Systems, Performance Systems International,
  1031.      March 1991.
  1032.  
  1033. [RFC1573]
  1034.      McCloghrie, K., and Kastenholtz, F., "Interfaces Group Evolution",
  1035.      RFC 1573, Hughes LAN Systems, FTP Software, January 1994.
  1036.  
  1037. [RFC1902]
  1038.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1039.      S. Waldbusser, "Structure of Management Information for version 2
  1040.      of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1041.      January 1996.
  1042.  
  1043. [RFC1903]
  1044.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1045.      S. Waldbusser, "Textual Conventions for version 2 of the Simple
  1046.      Network Management Protocol (SNMPv2)", RFC 1903, January 1996.
  1047.  
  1048. [RFC1904]
  1049.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1050.      S. Waldbusser, "Conformance Statements for version 2 of the Simple
  1051.      Network Management Protocol (SNMPv2)", RFC 1904, January 1996.
  1052.  
  1053. [RFC1905]
  1054.      SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1055.      S. Waldbusser, "Protocol Operations for version 2 of the Simple
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061. Bierman/McCloghrie       Expires January, 1998                 [Page 18]
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  1068.  
  1069.  
  1070.      Network Management Protocol (SNMPv2)", RFC 1905, January 1996.
  1071.  
  1072. [RFC2037]
  1073.      McCloghrie, K., Bierman, A., "Entity MIB using SMIv2", RFC 2037,
  1074.      Cisco Systems, October 1996.
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120. Bierman/McCloghrie       Expires January, 1998                 [Page 19]
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  1127.  
  1128.  
  1129. 8.  Security Considerations
  1130.  
  1131. This protocol and associated MIB can expose the existence of MAC and
  1132. network layer addresses used by devices within a given network.  A
  1133. network administrator may wish access to this management information,
  1134. using SNMP access control mechanisms, and restrict PDP advertisement
  1135. transmission to a particular set of ports, using the pdpTxSuppressTable.
  1136.  
  1137.  
  1138. 9.  Authors' Addresses
  1139.  
  1140.      Andy Bierman
  1141.      Cisco Systems, Inc.
  1142.      170 West Tasman Drive
  1143.      San Jose, CA 95134
  1144.      Phone: 408-527-3711
  1145.      Email: abierman@cisco.com
  1146.  
  1147.      Keith McCloghrie
  1148.      Cisco Systems, Inc.
  1149.      170 West Tasman Drive
  1150.      San Jose, CA 95134
  1151.      Phone: 408-526-5260
  1152.      Email: kzm@cisco.com
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179. Bierman/McCloghrie       Expires January, 1998                 [Page 20]
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185. Draft         Physical Topology Discovery Protocol and MIB     July 1997
  1186.  
  1187.  
  1188. Table of Contents
  1189.  
  1190.  
  1191. 1 Introduction ....................................................    1
  1192. 2 The SNMP Network Management Framework ...........................    2
  1193. 2.1 Object Definitions ............................................    2
  1194. 3 Overview ........................................................    3
  1195. 3.1 Terms .........................................................    3
  1196. 3.2 Persistent Identifiers ........................................    3
  1197. 3.3 Relationship to the Physical Topology MIB .....................    3
  1198. 3.4 Relationship to Entity MIB ....................................    4
  1199. 3.5 Relationship to Interfaces MIB ................................    4
  1200. 4 PTOPO Discovery Protocol ........................................    4
  1201. 4.1 Frame Encapsulation ...........................................    5
  1202. 4.2 PDP Message Format ............................................    5
  1203. 4.2.1 PDP Header Format ...........................................    5
  1204. 4.2.2 TLV Format ..................................................    6
  1205. 4.3 Standard TLV Definitions ......................................    8
  1206. 4.3.1 Chassis ID ..................................................    9
  1207. 4.3.2 Chassis Source ..............................................    9
  1208. 4.3.3 Port ID .....................................................   10
  1209. 4.3.4 Port Source .................................................   10
  1210. 4.3.5 Management Address ..........................................   11
  1211. 4.4 Protocol Operation ............................................   11
  1212. 4.4.1 Message Transmission ........................................   12
  1213. 4.4.2 Message Processing ..........................................   12
  1214. 4.4.3 Interface Shutdown Procedure ................................   12
  1215. 5 PTOPO Discovery Protocol MIB ....................................   12
  1216. 5.1 PDP MIB Definitions ...........................................   12
  1217. 6 Acknowledgements ................................................   17
  1218. 7 References ......................................................   18
  1219. 8 Security Considerations .........................................   20
  1220. 9 Authors' Addresses ..............................................   20
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238. Bierman/McCloghrie       Expires January, 1998                 [Page 21]
  1239.  
  1240.