Network Working Group M. Richardson INTERNET DRAFT S. Wright Expires August 2001 S. Hares NextHop February 2001 Definitions of Managed Objects for the Extended Communities Attribute in Border Gateway Protocol (BGP-4) Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC 2026. 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." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Copyright Notice Copyright (C) The Internet Society (1999). All Rights Reserved. Abstract This memo is an extension to the SNMP MIB. It specifies an IAB standards track protocol for the Internet community, and requests discussion and suggestions for improvements. This memo extends the MIB defined in [BGP-MIB]. Distribution of this memo is unlimited. Please forward comments to idr@merit.net. 1. Introduction This memo defines extensions to the MIB defined in [BGP-MIB]. In particular, it describes managed objects based upon attributes defined in "BGP Extended Communities Attribute" [BGP-EXTCOMM]. 2. Overview These objects are used to control and manage a BGP-4 implementation that supports BGP Extended Communities [BGP-EXTCOMM]. This MIB extends one table defined in [BGP-MIB]: the BGP-4 Received Path Attribute Table. This MIB defines the following primary objects: - bgp4ExtCommTable { bgp 13 1 } This table contains the set of extended communities received with each incoming route. 3. Definitions BGP4-EXT-COMM-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, mib-2 FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF bgp FROM BGP-MIB; bgpExtComm MODULE-IDENTITY LAST-UPDATED "200102230000Z" ORGANIZATION "IETF IDR Working Group" CONTACT-INFO "E-mail: idr@merit.net Mathew Richardson (Author) E-mail: mrr@nexthop.com Shane Wright (Author) E-mail: swright@nexthop.com 517 W. William Street Ann Arbor, MI 48103-4943 Tel: +1 734 973-2200 Fax: +1 734 615-3241 Susan Hares (Editor) 517 W. William Street Ann Arbor, MI 48103-4943 Tel: +1 734 933-2200 Fax: +1 734 615-3241 E-mail: skh@nexthop.com" REVISION "200102230000Z" DESCRIPTION "Extension of the MIB module for BGP-4 to include information about the Extended Communities attribute associated with incoming routes." REFERENCE "BGP-EXTCOMM - BGP Extended Communities Attribute" ::= { bgp 13 } bgp4ExtCommTable OBJECT-TYPE SYNTAX SEQUENCE OF Bgp4ExtCommEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "BGP Extended Communities Table. This table contains information on the Extended Communities [BGP-EXTCOMM] learned with incoming routes." REFERENCE "RFC 1771 - Border Gateway Protocol version 4 (BGP4)" ::= { bgpExtComm 1 } bgp4ExtCommEntry OBJECT-TYPE SYNTAX Bgp4ExtCommEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Information about the Extended Communities [BGP-EXTCOMM] learned with a route." AUGMENTS { bgp4PathAttrTable } ::= { bgp4ExtCommTable 1 } Bgp4ExtCommEntry ::= SEQUENCE { bgp4PathAttrExtComm OCTET STRING } bgp4PathAttrExtComm OBJECT-TYPE SYNTAX OCTET STRING (SIZE(0..4096)) MAX-ACCESS read-only STATUS current DESCRIPTION "A sequence of values each eight octets long, and each representing an extended community that was received with the route. The values of each of the individual octets may have semantic meaning. A length of zero (0) indicates the absence of this attribute." REFERENCE "BGP-EXTCOMM - BGP Extended Communities Attribute" ::= { bgp4ExtCommEntry 1 } END 4. Intellectual Property The IETF takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards-related documentation can be found in BCP-11. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementors or users of this specification can be obtained from the IETF Secretariat. 5. Acknowledgements The authors would like to thank the following individuals without whom this document would never have been possible: J. Haas, NextHop Technologies 6. References [BGP-MIB] Hares, S., Haas, J., "Definitions of Managed Objects for the Fourth Version of Border Gateway Protocol (BGP-4)", draft-ietf-idr-bgp4-mib-05.txt, December 2001. [BGP-EXTCOMM] Ramachandra, S., Tappan, D., "BGP Extended Communities Attribute", draft-ramachandra-bgp-ext-communities-08.txt, February 2001. 7. Security Considerations Security considerations are beyond the scope of this document. See [BGP-MIB] for a more detailed discussion of the security implications of this document. 8. Authors' Address Mathew Richardson NextHop Technologies 517 W. William Ann Arbor, MI 48103-4943 Phone: +1 734 973-2200 Fax: +1 734 615-3241 Email: mrr@nexthop.com Shane Wright NextHop Technologies 517 W. William Ann Arbor, MI 48103-4943 Phone: +1 734 973-2200 Fax: +1 734 615-3241 Email: swright@nexthop.com Susan Hares NextHop Technologies 517 W. William Ann Arbor, MI 48103-4943 Phone: +1 734 973-2200 Fax: +1 734 615-3241 Email: skh@nexthop.com 9. Full Copyright Statement Copyright (C) The Internet Society (1999). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Expires August 2001