INTERNET-DRAFT DS0 MIB February 1996 Definitions of Managed Objects for the DS0 and DS0 Bundle Interface Type Fri Feb 9 14:44:57 1996 draft-ietf-trunkmib-ds0-00.txt David Fowler (editor) Newbridge Networks davef@newbridge.com Status of this Memo This document is an Internet-Draft. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as ``work in progress.'' To learn the current status of any Internet-Draft, please check the ``1id-abstracts.txt'' listing contained in the Internet-Drafts Shadow Directories on ds.internic.net (US East Coast), nic.nordu.net (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific Rim). Abstract This memo defines an experimental portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes objects used for managing DS0 and DS0 Bundle interfaces. This document is a companion document with Definitions of Managed Objects for the DS1/E1/DS2/E2, DS3/E3 and SONET/SDH Interface Types, rfc1406 [6], rfc1407 [7] and rfc1595 [8]. This memo specifies a MIB module in a manner that is both compliant to the SNMPv2 SMI, and semantically identical to the peer SNMPv1 definitions. Expires August 1996 [Page 1] INTERNET-DRAFT DS0 MIB February 1996 This memo does not specify a standard for the Internet community. 1. The SNMPv2 Network Management Framework The SNMPv2 Network Management Framework consists of four major components. They are: o the SMI, described in RFC 1902 [1] - the mechanisms used for describing and naming objects for the purpose of management. o the MIB-II, STD 17, RFC 1213 [2] - the core set of managed objects for the Internet suite of protocols. o the protocol, STD 15, RFC 1157 [3] and/or RFC 1905 [4], - the protocol for accessing managed objects. The Framework permits new objects to be defined for the purpose of experimentation and evaluation. Expires August 1996 [Page 2] INTERNET-DRAFT DS0 MIB February 1996 2. Objects Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI. In particular, each object type is named by an OBJECT IDENTIFIER, an administratively assigned name. The object type together with an object instance serves to uniquely identify a specific instantiation of the object. For human convenience, we often use a textual string, termed the descriptor, to also refer to the object type. Expires August 1996 [Page 3] INTERNET-DRAFT DS0 MIB February 1996 3. Overview These objects are used when the particular media being used to realize an interface is a DS0 interface. At present, this applies to these values of the ifType variable in the Internet-standard MIB: ds0 (81) ds0Bundle (82) 3.1. Use of ifTable for DS0 Layer The following items are defined in rfc1573 [5]. Only the ifGeneralGroup needs to be supported. ifTable Object Use for DS0 Layer ====================================================================== ifIndex Interface index. ifDescr Textual Description of the interface ifType ds0(81) or ds0Bundle (82) ifSpeed 64000 for ds0 n * 64000 for ds0Bundle ifPhysAddress The value of the Circuit Identifier. If no Circuit Identifier has been assigned this object should have an octet string with zero length. ifAdminStatus Supports read-only access. The desired administrative status of the interface. ifOperStatus The current operational status of the interface. ifLastChange sysUpTime at the last change in ifOperStatus. ifName Textual name of the interface or an OCTET STRING of zero length. Expires August 1996 [Page 4] INTERNET-DRAFT DS0 MIB February 1996 ifLinkUpDownTrapEnable Set to disabled(2). Supports read-only access. ifHighSpeed 0 ifConnectorPresent Set to false(2). 3.2. Using ifStackTable This section describes by example how to use ifStackTable to represent the relationship of ds0 and ds0Bundles with ds1 interfaces. Example: A Frame Relay Service is being carried on 4 ds0s of a ds1. +---------------------+ | Frame Relay Service | +---------------------+ | +---------------------+ | ds0Bundle | +---------------------+ | | | | +---+ +---+ +---+ +---+ |ds0| |ds0| |ds0| |ds0| +---+ +---+ +---+ +---+ | | | | +---------------------+ | ds1 | +---------------------+ The assignment of the index values could for example be: ifIndex Description 1 FrameRelayService (type 44) 2 ds0Bundle (type 82) 3 ds0 #1 (type 81) 4 ds0 #2 (type 81) 5 ds0 #3 (type 81) 6 ds0 #4 (type 81) 7 ds1 (type 18) The ifStackTable is then used to show the relationships between the various interfaces. Expires August 1996 [Page 5] INTERNET-DRAFT DS0 MIB February 1996 ifStackTable Entries HigherLayer LowerLayer 0 1 1 2 2 3 2 4 2 5 2 6 3 7 4 7 5 7 6 7 7 0 In the case where the frameRelayService is using a single ds0, then the ds0Bundle is not required. +---------------------+ | Frame Relay Service | +---------------------+ | +---+ |ds0| +---+ | +---------------------+ | ds1 | +---------------------+ The assignment of the index values could for example be: ifIndex Description 1 FrameRelayService (type 44) 2 ds0 (type 81) 3 ds1 (type 18) The ifStackTable is then used to show the relationships between the various interfaces. ifStackTable Entries HigherLayer LowerLayer 0 1 Expires August 1996 [Page 6] INTERNET-DRAFT DS0 MIB February 1996 1 2 2 3 3 0 Expires August 1996 [Page 7] INTERNET-DRAFT DS0 MIB February 1996 4. Object Definitions for Ds0 DS0-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF ifIndex FROM IF-MIB transmission FROM RFC1213-MIB; -- This is the MIB module for the DS0 Interface objects. ds0 MODULE-IDENTITY LAST-UPDATED "9602072050Z" ORGANIZATION "IETF Trunk MIB Working Group" CONTACT-INFO " David Fowler Postal: Newbridge Networks Corporation 600 March Road Kanata, Ontario, Canada K2K 2E6 Tel: +1 613 591 3600 Fax: +1 613 591 3680 E-mail: davef@newbridge.com" DESCRIPTION "The MIB module to describe DS0 interfaces objects." ::= { transmission 81 } Expires August 1996 [Page 8] INTERNET-DRAFT DS0 MIB February 1996 -- The DS0 Config Group -- Implementation of this group is optional for all -- systems that use a DS0 Interface. -- The DS0 Config Group consists of one table: -- DS0 Configuration -- the DS0 Configuration Table dsx0ConfigTable OBJECT-TYPE SYNTAX SEQUENCE OF Dsx0ConfigEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The DS0 Configuration table." ::= { ds0 1 } dsx0ConfigEntry OBJECT-TYPE SYNTAX Dsx0ConfigEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the DS0 Configuration table." INDEX { ifIndex } ::= { dsx0ConfigTable 1 } Dsx0ConfigEntry ::= SEQUENCE { dsx0Ds0Number INTEGER, dsx0RBS INTEGER } dsx0Ds0Number OBJECT-TYPE SYNTAX INTEGER(1..31) MAX-ACCESS read-write STATUS current DESCRIPTION "This object indicates the channel number of the ds0 on its ds1/e1." ::= { dsx0ConfigEntry 1 } dsx0RBS OBJECT-TYPE Expires August 1996 [Page 9] INTERNET-DRAFT DS0 MIB February 1996 SYNTAX INTEGER { dsx0RBSOn(1), dsx0RBSOff(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "This object indicates if Robbed Bit Signalling is turned on or off for a given ds0." ::= { dsx0ConfigEntry 2 } -- conformance information ds0Conformance OBJECT IDENTIFIER ::= { ds0 2 } ds0Groups OBJECT IDENTIFIER ::= { ds0Conformance 1 } ds0Compliances OBJECT IDENTIFIER ::= { ds0Conformance 2 } -- compliance statements ds0Compliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for DS0 interfaces." MODULE -- this module GROUP ds0ConfigGroup DESCRIPTION "Implementation of this group is optional for all systems that attach to a DS0 Interface." ::= { ds0Compliances 1 } -- units of conformance ds0ConfigGroup OBJECT-GROUP OBJECTS { dsx0Ds0Number, dsx0RBS } STATUS current DESCRIPTION "A collection of objects providing configuration information applicable to all DS0 interfaces." ::= { ds0Groups 1 } END Expires August 1996 [Page 10] INTERNET-DRAFT DS0 MIB February 1996 5. Object Definitions for Ds0 Bundle DS0BUNDLE-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF RowStatus FROM SNMPv2-TC ifIndex FROM IF-MIB transmission FROM RFC1213-MIB; -- This is the MIB module for the DS0Bundle Interface objects. ds0Bundle MODULE-IDENTITY LAST-UPDATED "9602072050Z" ORGANIZATION "IETF Trunk MIB Working Group" CONTACT-INFO " David Fowler Postal: Newbridge Networks Corporation 600 March Road Kanata, Ontario, Canada K2K 2E6 Tel: +1 613 591 3600 Fax: +1 613 591 3680 E-mail: davef@newbridge.com" DESCRIPTION "The MIB module to describe DS0 Bundle interfaces objects." ::= { transmission 82 } Expires August 1996 [Page 11] INTERNET-DRAFT DS0 MIB February 1996 -- The DS0 Bonding Group -- Implementation of this group is optional for all -- systems that use a DS0Bundle Interface. -- The DS0 Bonding Group consists of one table: -- DS0 Bonding -- the DS0 Bonding Table dsx0BondingTable OBJECT-TYPE SYNTAX SEQUENCE OF Dsx0BondingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The DS0 Bonding table." ::= { ds0Bundle 1 } dsx0BondingEntry OBJECT-TYPE SYNTAX Dsx0BondingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the DS0 Bonding table." INDEX { ifIndex } ::= { dsx0BondingTable 1 } Dsx0BondingEntry ::= SEQUENCE { dsx0BondMode INTEGER, dsx0BondStatus INTEGER, dsx0BondRowStatus RowStatus } dsx0BondMode OBJECT-TYPE SYNTAX INTEGER { dsx0BondModeNone(1), dsx0BondModeOther(2), dsx0BondMode0(3), dsx0BondMode1(4), dsx0BondMode2(5), dsx0BondMode3(6) Expires August 1996 [Page 12] INTERNET-DRAFT DS0 MIB February 1996 } MAX-ACCESS read-create STATUS current DESCRIPTION "This object indicates which BONDing mode is used, if any, for a ds0Bundle. Mode0 provides paramter and number exchange with no synchronization. Mode1 provides parameter but not number exchange with no synchronization. Mode2 does synchronization detection using in-band monitoring. Mode3 does perform synchronization detection using single channel overhead." ::= { dsx0BondingEntry 1 } dsx0BondStatus OBJECT-TYPE SYNTAX INTEGER { dsx0BondIdle(1), dsx0BondCallSetup(2), dsx0BondDataTransfer(3) } MAX-ACCESS read-create STATUS current DESCRIPTION "This object indicates the current status of the bonding call using this ds0Bundle. dsx0BondIdle (1) should be used when the bonding mode is set to dsx0BondModeNode (1)." ::= { dsx0BondingEntry 2 } dsx0BondRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This object is used to create new rows in this table, modify existing rows, and to delete existing rows." ::= { dsx0BondingEntry 3 } -- conformance information ds0BundleConformance OBJECT IDENTIFIER ::= { ds0Bundle 2 } Expires August 1996 [Page 13] INTERNET-DRAFT DS0 MIB February 1996 ds0BundleGroups OBJECT IDENTIFIER ::= { ds0BundleConformance 1 } ds0BundleCompliances OBJECT IDENTIFIER ::= { ds0BundleConformance 2 } -- compliance statements ds0BundleCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for DS0Bundle interfaces." MODULE -- this module GROUP ds0BondingGroup DESCRIPTION "Implementation of this group is optional for all systems that attach to a DS0Bundle Interface." ::= { ds0BundleCompliances 1 } -- units of conformance ds0BondingGroup OBJECT-GROUP OBJECTS { dsx0BondMode, dsx0BondStatus dsx0BondRowStatus } STATUS current DESCRIPTION "A collection of objects providing configuration information applicable to all DS0 interfaces." ::= { ds0BundleGroups 1 } END 6. Acknowledgments This document was produced by the Trunk MIB Working Group: Expires August 1996 [Page 14] INTERNET-DRAFT DS0 MIB February 1996 7. References [1] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure of Management Information for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1902, January 1996. [2] McCloghrie, K., and M. Rose, Editors, "Management Information Base for Network Management of TCP/IP-based internets: MIB-II", STD 17, RFC 1213, Hughes LAN Systems, Performance Systems International, March 1991. [3] Case, J., Fedor, M., Schoffstall, M., and J. Davin. " A Simple Network Management Protocol (SNMP)", STD 15, RFC 1157, SNMP Research, Performance Systems International, MIT Lab for Computer Science, May 1990. [4] SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1905, January 1996. [5] McCloghrie, K. and F. Kastenholz, "Evolution of the Interfaces Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software, January 1994. [6] Fowler, D., "Definitions of Managed Objects for the DS1/E1/DS2/E2 Interface Types", RFC1406, Newbridge Networks, February 1996. [7] Fowler, D., "Definitions of Managed Objects for the DS3/E3 Interface Types", RFC1407, Newbridge Networks, February 1996. [8] Brown, T., and Tesink, K., "Definitions of Managed Objects for the SONET/SDH Interface Type", RFC1595, Bell Communications Research, March 1994. Expires August 1996 [Page 15] INTERNET-DRAFT DS0 MIB February 1996 8. Security Considerations Security issues are not discussed in this memo. 9. Authors' Addresses David Fowler Newbridge Networks 600 March Road Kanata, Ontario, Canada K2K 2E6 Phone: (613) 599-3600, ext 3538 EMail: davef@newbridge.com Expires August 1996 [Page 16] INTERNET-DRAFT DS0 MIB February 1996 Table of Contents 1 The SNMPv2 Network Management Framework ...................... 2 2 Objects ...................................................... 3 3 Overview ..................................................... 4 3.1 Use of ifTable for DS0 Layer ............................... 4 3.2 Using ifStackTable ......................................... 5 4 Object Definitions for Ds0 ................................... 8 4.1 The DS0 Config Group ....................................... 9 4.1.1 The DS0 Configuration Table .............................. 9 5 Object Definitions for Ds0 Bundle ............................ 11 5.1 The DS0 Bonding Group ...................................... 12 5.1.1 The DS0 Bonding Table .................................... 12 6 Acknowledgments .............................................. 14 7 References ................................................... 15 8 Security Considerations ...................................... 16 9 Authors' Addresses ........................................... 16 Expires August 1996 [Page 17]