Network Working Group S. Adwankar Internet-Draft Motorola Expires: April 24, 2006 S. Chisholm Nortel October 21, 2005 Reporting Schema for NetConf Protocol draft-adwankar-netconf-reporting-01.txt Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. 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.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire on April 24, 2006. Copyright Notice Copyright (C) The Internet Society (2005). Abstract This memo defines XML Schema for reporting information about the NetConf system. Adwankar & Chisholm Expires April 24, 2006 [Page 1] Internet-Draft Reporting Schema for NetConf Protocol October 2005 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. NetConf Reporting Schema . . . . . . . . . . . . . . . . . . 4 3. NetConf Reporting Example . . . . . . . . . . . . . . . . . 10 4. Security Considerations . . . . . . . . . . . . . . . . . . 12 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . 13 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 14 7. References . . . . . . . . . . . . . . . . . . . . . . . . . 14 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . 14 Intellectual Property and Copyright Statements . . . . . . . 16 Adwankar & Chisholm Expires April 24, 2006 [Page 2] Internet-Draft Reporting Schema for NetConf Protocol October 2005 1. Introduction NETCONF [NETCONF] configuration protocol defines Extensible Markup Language [XML] based mechanisms to install, manipulate, and delete the configuration of network devices. Layer Example +-------------+ +-----------------------------+ | State | | Reporting data | +-------------+ +-----------------------------+ | | +-------------+ +-----------------------------+ | Content | | Configuration data | +-------------+ +-----------------------------+ | | +-------------+ +-----------------------------+ | Operations | | , | +-------------+ +-----------------------------+ | | +-------------+ +-----------------------------+ | RPC | | , | +-------------+ +-----------------------------+ | | +-------------+ +-----------------------------+ | Application | | BEEP, SSH, SSL, console | | Protocol | | | +-------------+ +-----------------------------+ Framework for Netconf Content [NETMOD] provides guidance for the creation of data model that defines NetConf Content. This document defines XML Schema that will be useful for reporting information about the NetConf system. Figure 1 Adwankar & Chisholm Expires April 24, 2006 [Page 3] Internet-Draft Reporting Schema for NetConf Protocol October 2005 2. NetConf Reporting Schema The Netconf architecture supports a clear separation between content and the underlying protocol operations, RPCs and transport that make up the Netconf server. The Netconf architecture also supports a separation between content and state data. The following is the schema to report on this underlying state information. Initial schema for NETCONF state information. NetConf State Schema 2005-10-17T09:30:47-05:00 IETF The Description of NetConf State Schema List of NETCONF capabilities supported Adwankar & Chisholm Expires April 24, 2006 [Page 4] Internet-Draft Reporting Schema for NetConf Protocol October 2005 by this device. List of NETCONF sessions currently active on this device. Adwankar & Chisholm Expires April 24, 2006 [Page 5] Internet-Draft Reporting Schema for NetConf Protocol October 2005 List of NETCONF configuration databases supported on this device. Adwankar & Chisholm Expires April 24, 2006 [Page 6] Internet-Draft Reporting Schema for NetConf Protocol October 2005 Adwankar & Chisholm Expires April 24, 2006 [Page 8] Internet-Draft Reporting Schema for NetConf Protocol October 2005 Adwankar & Chisholm Expires April 24, 2006 [Page 9] Internet-Draft Reporting Schema for NetConf Protocol October 2005 3. NetConf Reporting Example Get NetConf reporting information. RPC Request : RPC Reply : locked 1 unlocked unlocked 1 Adwankar & Chisholm Expires April 24, 2006 [Page 10] Internet-Draft Reporting Schema for NetConf Protocol October 2005 Tom 10:23:01 AM 6 Bob 2:56:01 PM Adwankar & Chisholm Expires April 24, 2006 [Page 11] Internet-Draft Reporting Schema for NetConf Protocol October 2005 4. Security Considerations To be determined once specific aspects of this solution are better understood. Adwankar & Chisholm Expires April 24, 2006 [Page 12] Internet-Draft Reporting Schema for NetConf Protocol October 2005 5. IANA Considerations TBD. Adwankar & Chisholm Expires April 24, 2006 [Page 13] Internet-Draft Reporting Schema for NetConf Protocol October 2005 6. Acknowledgements This document is a result of discussions at IETF 59 and 60, as well as on the mailing list by the following people: Sharon Chisholm, David Harrington, Ray Atarashi, Yoshifumi Atarashi, Bert Wijnen, Andy Bierman, Randy Presuhn, Chris Lonvick, Eliot Lear, Avri Doria, Juergen Schoenwaelder, Rob Ennes, Faye Ly, Andre Westerinen and Subrata Mazumdar. 7. References [NETCONF] Enns, R., "NETCONF Configuration Protocol", ID draft-ietf-netconf-prot-09, October 2005. [NETMOD] Chisholm, S. and S. Adwankar, "Framework for Netconf Data Models", ID draft-chisholm-netconf-model-03, June 2005. [URI] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform Resource Identifiers (URI): Generic Syntax", RFC 2396, August 1998. [XML] World Wide Web Consortium, "Extensible Markup Language (XML) 1.0", W3C XML, February 1998, . [refs.RFC2026] Bradner, S., "The Internet Standards Process -- Revision 3", RFC 2026, BCP 9, October 1996. [refs.RFC2119] Bradner, s., "Key words for RFCs to Indicate Requirements Levels", RFC 2119, March 1997. [refs.RFC2223] Postel, J. and J. Reynolds, "Instructions to RFC Authors", RFC 2223, October 1997. Adwankar & Chisholm Expires April 24, 2006 [Page 14] Internet-Draft Reporting Schema for NetConf Protocol October 2005 Authors' Addresses Sandeep Adwankar Motorola 1301 East Algonquin Road MS IL02-2240 Schaumburg, IL 60196 USA Email: sandeep.adwankar@motorola.com Sharon Chisholm Nortel 3500 Carling Ave Nepean, Ontario K2H 8E9 Canada Email: schishol@nortel.com Adwankar & Chisholm Expires April 24, 2006 [Page 15] Internet-Draft Reporting Schema for NetConf Protocol October 2005 Intellectual Property Statement The IETF takes no position regarding the validity or scope of any Intellectual Property Rights 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; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat 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 implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. The IETF has been notified of intellectual property rights claimed in regard to some or all of the specification contained in this document. For more information consult the online list of claimed rights. Disclaimer of Validity This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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. Copyright Statement Copyright (C) The Internet Society (2005). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. Adwankar & Chisholm Expires April 24, 2006 [Page 16] Internet-Draft Reporting Schema for NetConf Protocol October 2005 Acknowledgment Funding for the RFC Editor function is currently provided by the Internet Society. Adwankar & Chisholm Expires April 24, 2006 [Page 17]