From: http://www.ietf.org/internet-drafts/draft-ietf-netconf-monitoring-12.txt Title: YANG Module for NETCONF Monitoring Reference: IETF Network Working Group, Internet Draft 'draft-ietf-netconf-monitoring-12' Date: February 23, 2010 I-D Tracker: http://ietfreport.isoc.org/idref/draft-ietf-netconf-monitoring/ Tools: http://tools.ietf.org/html/draft-ietf-netconf-monitoring-12 (HTML) Diff with version -11: http://tools.ietf.org/rfcdiff?url2=draft-ietf-netconf-monitoring-12.txt Announced: http://www.ietf.org/mail-archive/web/i-d-announce/current/msg29635.html Last Call announced: http://www.ietf.org/mail-archive/web/ietf-announce/current/msg07374.html See also: IETF Network Configuration (NETCONF) Working Group http://www.ietf.org/html.charters/netconf-charter.html IETF NETCONF Working Group Status Pages http://tools.ietf.org/wg/netconf/ IETF NETCONF Working Group Information Pages (Simon Leinen) http://www.ops.ietf.org/netconf/ IETF NETCONF WG Mailing List http://ops.ietf.org/lists/netconf/ NETCONF Configuration Protocol http://www.ietf.org/rfc/rfc4741.txt IETF Operations and Management Area http://tools.ietf.org/area/ops/ ============================================================================== Network Working Group M. Scott Internet-Draft Ericsson Intended status: Standards Track M. Bjorklund Expires: August 27, 2010 Tail-f Systems February 23, 2010 YANG Module for NETCONF Monitoring draft-ietf-netconf-monitoring-12 Abstract This document defines a NETCONF data model to be used to monitor the NETCONF protocol. The monitoring data model includes information about NETCONF datastores, sessions, locks and statistics. This data facilitates the management of a NETCONF server. This document also defines methods for NETCONF clients to discover data models supported by a NETCONF server and defines a new NETCONF operation to retrieve them. Status of this Memo This Internet-Draft is submitted to IETF in full conformance with the provisions of BCP 78 and 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 August 27, 2010. Copyright Notice Copyright (c) 2010 IETF Trust and the persons identified as the document authors. All rights reserved. Scott & Bjorklund Expires August 27, 2010 [Page 1] Internet-Draft YANG Module for NETCONF Monitoring February 2010 This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the BSD License. This document may contain material from IETF Documents or IETF Contributions published or made publicly available before November 10, 2008. The person(s) controlling the copyright in some of this material may not have granted the IETF Trust the right to allow modifications of such material outside the IETF Standards Process. Without obtaining an adequate license from the person(s) controlling the copyright in such materials, this document may not be modified outside the IETF Standards Process, and derivative works of it may not be created outside the IETF Standards Process, except to format it for publication as an RFC or to translate it into languages other than English. Scott & Bjorklund Expires August 27, 2010 [Page 2] Internet-Draft YANG Module for NETCONF Monitoring February 2010 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Definition of Terms . . . . . . . . . . . . . . . . . . . 3 2. Data Model to Monitor NETCONF . . . . . . . . . . . . . . . . 4 2.1. The /netconf-state Subtree . . . . . . . . . . . . . . . . 4 2.1.1. The /netconf-state/capabilities Subtree . . . . . . . 5 2.1.2. The /netconf-state/datastores Subtree . . . . . . . . 5 2.1.3. The /netconf-state/schemas Subtree . . . . . . . . . . 5 2.1.4. The /netconf-state/sessions Subtree . . . . . . . . . 6 2.1.5. The /netconf-state/statistics Subtree . . . . . . . . 7 3. Schema Specific Operations . . . . . . . . . . . . . . . . . . 9 3.1. The Operation . . . . . . . . . . . . . . . . 9 4. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.1. Retrieving Schema List via Operation . . . . . . . . 10 4.2. Retrieving Schema Instances . . . . . . . . . . . . . . . 11 5. NETCONF Monitoring Data Model . . . . . . . . . . . . . . . . 14 6. Security Considerations . . . . . . . . . . . . . . . . . . . 26 7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 27 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 28 9. Appendix A - Change Log . . . . . . . . . . . . . . . . . . . 29 9.1. draft-ietf-netconf-monitoring-12 . . . . . . . . . . . . . 29 9.2. draft-ietf-netconf-monitoring-11 . . . . . . . . . . . . . 29 9.3. draft-ietf-netconf-monitoring-10 . . . . . . . . . . . . . 31 9.4. draft-ietf-netconf-monitoring-09 . . . . . . . . . . . . . 31 9.5. draft-ietf-netconf-monitoring-08 . . . . . . . . . . . . . 32 9.6. draft-ietf-netconf-monitoring-07 . . . . . . . . . . . . . 32 9.7. draft-ietf-netconf-monitoring-06 . . . . . . . . . . . . . 32 9.8. draft-ietf-netconf-monitoring-05 . . . . . . . . . . . . . 32 9.9. draft-ietf-netconf-monitoring-04 . . . . . . . . . . . . . 33 9.10. draft-ietf-netconf-monitoring-03 . . . . . . . . . . . . . 33 9.11. draft-ietf-netconf-monitoring-02 . . . . . . . . . . . . . 33 9.12. draft-ietf-netconf-monitoring-01 . . . . . . . . . . . . . 33 9.13. draft-scott-netconf-monitoring-00 . . . . . . . . . . . . 34 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 35 10.1. Normative References . . . . . . . . . . . . . . . . . . . 35 10.2. Informative References . . . . . . . . . . . . . . . . . . 35 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 37 Scott & Bjorklund Expires August 27, 2010 [Page 3] Internet-Draft YANG Module for NETCONF Monitoring February 2010 1. Introduction This document defines a [YANG] model to be used to monitor the NETCONF protocol. It provides information about NETCONF sessions and supported schema as defined in [4741bis]. Considerations such as different schema formats, feature optionality and access controls can all impact the applicability and level of detail the NETCONF server sends to a client during session setup. The methods defined in this document address the need for further means to query and retrieve schema and NETCONF state information from a NETCONF server. These are provided to complement existing base NETCONF capabilities and operations and in no way affect existing behaviour. A new operation is also defined to support explicit schema retrieval via NETCONF. 1.1. Definition of Terms The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14, [RFC2119]. Scott & Bjorklund Expires August 27, 2010 [Page 4] Internet-Draft YANG Module for NETCONF Monitoring February 2010 2. Data Model to Monitor NETCONF The NETCONF monitoring data model defined in this document provides operational information on the NETCONF server. This includes details specific to the NETCONF protocol (e.g. protocol specific counters such as 'in-sessions') as well as data related to schema retrieval (e.g. schema list). A server that implements the data model defined in this document MUST advertise the capability URI "urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring". An overview of the specific monitoring data defined in this document which MUST be present follows. For detailed descriptions refer to the normative YANG module provided in this document (see section 5). 2.1. The /netconf-state Subtree The netconf-state container is the root of the monitoring data model. netconf-state /capabilities /datastores /schemas /sessions /statistics capabilities List of NETCONF capabilities supported by the server. datastores List of NETCONF configuration datastores (e.g. running, startup, candidate) supported on this device and related information. schemas List of schemas supported on the server. Includes all the information required to identify the schemas and to support their retrieval. sessions List of all active NETCONF sessions on the device. Includes per session counters for all NETCONF sessions. statistics Includes global counters for the NETCONF server. Scott & Bjorklund Expires August 27, 2010 [Page 5] Internet-Draft YANG Module for NETCONF Monitoring February 2010 2.1.1. The /netconf-state/capabilities Subtree The /netconf-state/capabilities subtree contains the capabilities supported by the NETCONF server. The list MUST include all capabilities exchanged during session setup still applicable at the time of the request. 2.1.2. The /netconf-state/datastores Subtree The /netconf-state/datastores subtree contains the list of available datastores for the NETCONF server and includes information on their lock state. configuration /name /locks name (container, netconf-datastore-type) Enumeration of supported datastores; candidate, running, startup. locks (grouping, lock-info) List of locks for the datastore. Information is provided for both global and partial locks. For partial locks the list of locked nodes and the select expressions originally used to request the lock are returned. 2.1.3. The /netconf-state/schemas Subtree Scott & Bjorklund Expires August 27, 2010 [Page 6] Internet-Draft YANG Module for NETCONF Monitoring February 2010 The list of supported schema for the NETCONF server. schema /identifier (key) /version (key) /format (key) /namespace /location The elements identifier, version, and format are used as a key in the schema list. These are used in the operation. identifier (string) Identifier for the schema list entry. Identifier is used in the operation and may be used for other means such as file retrieval. version (string) Version of the schema supported. Multiple versions MAY be supported simultaneously by a NETCONF server. format (identifyref, schema-format) The data modeling language the schema is written in (currently xsd, yang, yin, rng or rnc). namespace(inet:uri) The XML namespace defined by the schema. location (union: enum, inet:uri) One of more locations from which this specific schema can be retrieved. The list SHOULD contain at least one entry per schema. 2.1.4. The /netconf-state/sessions Subtree Includes session specific data for NETCONF management sessions. The session list MUST include all currently active NETCONF sessions. sessions: session /session-id (key) /transport /username /source-host /login-time /in-rpcs Scott & Bjorklund Expires August 27, 2010 [Page 7] Internet-Draft YANG Module for NETCONF Monitoring February 2010 /in-bad-rpcs /out-rpc-errors /out-notifications session-id (session-id) Unique identifier for the session. This value is the NETCONF session identifier, as defined in [RFC4741]. transport (identityref, transport) Identifies transport for each session, e.g. "netconf-ssh", "netconf-soap", etc. username (string) If present, the username contains an identifier which can be used to uniquely identify an individual client (human or machine). source-host (inet:host) Host identifier (IP address or name) of the client. login-time (yang:date-and-time) Time at which the session was established. in-rpcs (yang:zero-based-counter32) Number of correct requests received. in-bad-rpcs (yang:zero-based-counter32) Number of messages received when a message was expected, that were not correct messages. This includes XML parse errors and errors on the rpc layer. out-rpc-errors (yang:zero-based-counter32) Number of messages sent which contained an element. out-notifications (yang:zero-based-counter32) Number of messages sent. 2.1.5. The /netconf-state/statistics Subtree Scott & Bjorklund Expires August 27, 2010 [Page 8] Internet-Draft YANG Module for NETCONF Monitoring February 2010 Statistical data pertaining to the NETCONF server. statistics /netconf-start-time /in-bad-hellos /in-sessions /dropped-sessions /in-rpcs /in-bad-rpcs /out-rpc-errors /out-notifications statistics: Contains management session related performance data for the NETCONF server. netconf-start-time (yang:date-and-time) Date and time at which the management subsystem was started. in-bad-hellos (yang:zero-based-counter32) Number of sessions silently dropped because an invalid message was received. in-sessions (yang:zero-based-counter32) Number of sessions started. dropped-sessions (yang:zero-based-counter32) Number of sessions that were abnormally terminated, e.g. due to idle timeout or transport close. in-rpcs (yang:zero-based-counter32) Number of correct requests received. in-bad-rpcs (yang:zero-based-counter32) Number of messages received when a message was expected, that were not correct messages. out-rpc-errors (yang:zero-based-counter32) Number of messages sent which contained an element. out-notifications (yang:zero-based-counter32) Number of messages sent. Scott & Bjorklund Expires August 27, 2010 [Page 9] Internet-Draft YANG Module for NETCONF Monitoring February 2010 3. Schema Specific Operations 3.1. The Operation Description: This operation is used to retrieve a schema from the NETCONF server. Parameters: identifier (string): Identifier for the schema list entry. Mandatory parameter. version (string): Version of the schema requested. Optional parameter. format (identityref, schema-format): The data modeling language of the schema. Default value is 'yang' when not specified. Optional parameter. Positive Response: The NETCONF server returns the requested schema. Negative Response: If requested schema does not exist, the is 'invalid-value'. If requested schema is not unique, the is 'operation-failed', and is 'data-not-unique'. Scott & Bjorklund Expires August 27, 2010 [Page 10] Internet-Draft YANG Module for NETCONF Monitoring February 2010 4. Examples 4.1. Retrieving Schema List via Operation A NETCONF client retrieves the list of supported schema from a NETCONF server by retrieving the /netconf-state/schemas subtree via a operation. Available schema for the requesting session are returned in the reply containing the ,, , and elements. The response data can be used to determine the available schema and their versions. The schema itself (i.e., schema content) is not returned in the response. The optional element contains a URI, which can be used to retrieve the schema by another protocol such as ftp or http(s), or the special value 'NETCONF', which means that the schema can be retrieved from the device via the operation. Example: The NETCONF server returns a list of schema available for retrieval. foo 1.0 Scott & Bjorklund Expires August 27, 2010 [Page 11] Internet-Draft YANG Module for NETCONF Monitoring February 2010 xsd http://example.com/foo ftp://ftp.example.com/schemas/foo_1.0.xsd http://www.example.com/schema/foo_1.0.xsd NETCONF foo 1.1 xsd http://example.com/foo ftp://ftp.example.com/schemas/foo_1.1.xsd http://www.example.com/schema/foo_1.1.xsd NETCONF bar 2008-06-01 yang http://example.com/bar http://example.com/schema/bar@2008-06-01.yang NETCONF bar-types 2008-06-01 yang http://example.com/bar http://example.com/schema/bar-types@2008-06-01.yang NETCONF 4.2. Retrieving Schema Instances Given the reply in the previous section, the following examples illustrate the retrieval of 'foo', 'bar', and 'bar-types' schema at multiple locations, with multiple formats, and in multiple locations. 1. foo, version 1.0 in xsd format: Scott & Bjorklund Expires August 27, 2010 [Page 12] Internet-Draft YANG Module for NETCONF Monitoring February 2010 a. Via FTP using location ftp://ftp.example.com/schemas/foo_1.0.xsd b. Via HTTP using location http://www.example.com/schema/foo_1.0.xsd c. Via using identifier, version, and format parameters. foo 1.0 xsd 2. bar, version 2008-06-01 in YANG format: a. Via HTTP using location http://example.com/schema/bar@2008-06-01.yang b. Via using identifer and version parameters: bar 2008-06-01 module bar { //default format (yang) returned //bar version 2008-06-01 yang module //contents here ... } 3. bar-types, version 2008-06-01 in default YANG format: a. Via using identifer parameter: bar-types module bar-types { //default format (yang) returned //latest revision returned //is version 2008-06-01 yang module //contents here ... } Scott & Bjorklund Expires August 27, 2010 [Page 14] Internet-Draft YANG Module for NETCONF Monitoring February 2010 5. NETCONF Monitoring Data Model The data model described in this memo is defined in the following YANG module. module ietf-netconf-monitoring { namespace "urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring:DRAFT-12"; prefix "ns"; import ietf-yang-types { prefix yang; } import ietf-inet-types { prefix inet; } organization "IETF NETCONF (Network Configuration) Working Group"; contact "WG Web: WG List: WG Chair: Mehmet Ersue WG Chair: Bert Wijnen Editor: Mark Scott "; description "NETCONF Monitoring Module. All elements in this module are read-only. Copyright (c) 2009 IETF Trust and the persons identified as the document authors. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). Scott & Bjorklund Expires August 27, 2010 [Page 15] Internet-Draft YANG Module for NETCONF Monitoring February 2010 This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices."; // RFC Ed.: replace XXXX with actual RFC number and remove this note revision 2010-02-18 { description "Initial revision."; reference "RFC XXXX: YANG Module for NETCONF Monitoring"; // RFC Ed.: replace XXXX with actual RFC number and remove this note } // 'session-id-type' from 'ietf-netconf' module // can be replaced with import when 4741bis is published typedef session-id { type uint32 { range "1..max"; } description "NETCONF Session Id."; reference "RFC 4741: NETCONF Configuration Protocol"; } // to be added to base protocol 'ietf-netconf' module // and imported when 4741bis is published grouping netconf-datastore-type { description "Enumeration of possible NETCONF datastore types."; reference "RFC 4741: NETCONF Configuration Protocol"; choice datastore { mandatory true; leaf running { type empty; } leaf candidate { type empty; } leaf startup { type empty; } } } identity transport { description "Base identity for NETCONF transport types."; Scott & Bjorklund Expires August 27, 2010 [Page 16] Internet-Draft YANG Module for NETCONF Monitoring February 2010 } identity netconf-ssh { base transport; description "NETCONF over Secure Shell (SSH)."; reference "RFC 4742: Using the NETCONF Configuration Protocol over Secure SHell (SSH)"; } identity netconf-soap-over-beep { base transport; description "NETCONF Simple Object Access Protocol (SOAP) over Blocks Extensible Exchange Protocol (BEEP)."; reference "RFC 4743: Using NETCONF over the Simple Object Access Protocol (SOAP)"; } identity netconf-soap-over-https { base transport; description "NETCONF Simple Object Access Protocol (SOAP) over Hypertext Transfer Protocol Secure (HTTPS)."; reference "RFC 4743: Using NETCONF over the Simple Object Access Protocol (SOAP)"; } identity netconf-beep { base transport; description "NETCONF over Blocks Extensible Exchange Protocol (BEEP)."; reference "RFC 4744: Using the NETCONF Protocol over the Blocks Extensible Exchange Protocol (BEEP)"; } identity netconf-tls { base transport; description "NETCONF over Transport Layer Security (TLS)."; reference "RFC 5539: NETCONF over Transport Layer Security (TLS)"; } Scott & Bjorklund Expires August 27, 2010 [Page 17] Internet-Draft YANG Module for NETCONF Monitoring February 2010 identity schema-format { description "Base identity for data model schema languages."; } identity xsd { base schema-format; description "XML Schema Definition."; reference "W3C REC REC-xmlschema-1-20041028: XML Schema Part 1: Structure W3C REC REC-xmlschema-2-20041028: XML Schema Part 2: Datatypes"; } identity yang { base schema-format; description "YANG is a data modeling language used to model configuration and state data manipulated by the NETCONF protocol."; reference "RFC XXXX: YANG - A data modeling language for NETCONF"; // RFC Ed.: replace XXXX with actual RFC number and remove this note } identity yin { base schema-format; reference "YIN is an alternative, equivalent XML syntax for YANG."; reference "RFC XXXX: YANG - A data modeling language for NETCONF"; // RFC Ed.: replace XXXX with actual RFC number and remove this note } identity rng { base schema-format; description "Regular Language for XML Next Generation (RELAX NG)."; reference "ISO/IEC 19757-2: RELAX NG"; } identity rnc { base schema-format; description "Relax NG Compact Syntax"; reference "ISO/IEC 19757-2: RELAX NG"; } Scott & Bjorklund Expires August 27, 2010 [Page 18] Internet-Draft YANG Module for NETCONF Monitoring February 2010 grouping common-counters { description "Counters that exist both per session, and also globally, accumulated from all sessions."; leaf in-rpcs { type yang:zero-based-counter32; description "Number of correct messages received."; } leaf in-bad-rpcs { type yang:zero-based-counter32; description "Number of messages received when a message was expected, that were not correct messages. This includes XML parse errors and errors on the rpc layer."; } leaf out-rpc-errors { type yang:zero-based-counter32; description "Number of messages sent which contained an element."; } leaf out-notifications { type yang:zero-based-counter32; description "Number of messages sent."; } } container netconf-state { config false; description "The netconf-state container is the root of the monitoring data model."; container capabilities { description "List of NETCONF capabilities supported by the server."; leaf-list capability { type inet:uri; } } container datastores { description "The datastores container provides the list of NETCONF Scott & Bjorklund Expires August 27, 2010 [Page 19] Internet-Draft YANG Module for NETCONF Monitoring February 2010 configuration datastores (e.g. running, startup, candidate) supported on this device and related information."; list datastore { container name { uses netconf-datastore-type; } container locks { description "The NETCONF and operations allow a client to lock specific resources in a datastore. The NETCONF server will prevent changes to the locked resources by all sessions except the one which acquired the lock(s). Monitoring information is provided for each datastore entry including details such as the session which acquired the lock, the type of lock (global or partial) and the list of locked resources. Multiple locks per datastore are supported."; grouping lock-info { leaf locked-by-session { type session-id; description "The session ID of the session that has locked this resource. Both a global lock and a partial lock MUST contain the NETCONF session-id."; } leaf locked-time { type yang:date-and-time; description "The date and time of when the resource was locked."; } } choice lock-type { container global-lock { description "Present if the global lock is set."; uses lock-info; } list partial-locks { key lock-id; description Scott & Bjorklund Expires August 27, 2010 [Page 20] Internet-Draft YANG Module for NETCONF Monitoring February 2010 "List of partial locks."; reference "RFC 5717: Partial Lock Remote Procedure Call (RPC) for NETCONF"; leaf lock-id { type uint32; description "For a partial lock this is the lock id returned in the response."; } uses lock-info; leaf-list select { type string; min-elements 1; description "The xpath expression which was used to request the lock. The select expression indicates the original intended scope of the lock."; } leaf-list locked-nodes { type instance-identifier; description "The list of instance-identifiers (i.e. the locked nodes). The scope of the partial lock is defined by the list of locked nodes."; } } } } } } container schemas { list schema { key "identifier version format"; leaf identifier { type string; description "Identifier to uniquely reference the schema. Identifier is used in the operation and may be used for other purposes such as file retrieval. For modeling languages which support or require a data Scott & Bjorklund Expires August 27, 2010 [Page 21] Internet-Draft YANG Module for NETCONF Monitoring February 2010 model name (eg: YANG module name) the identifier MUST match that name. For YANG data models, the identifier is the name of the module or submodule. In other cases an identifier such as a filename MAY be used instead."; } leaf version { type string; description "Version of the schema supported. Multiple versions MAY be supported simultaneously by a NETCONF server. Each version MUST be reported individually in the schema list, i.e. with same identifier, possibly different location, but different version. For YANG data models, version is the value of the most recent YANG 'revision' statement in the module or submodule, or the empty string if no revision statement is present."; } leaf format { type identityref { base schema-format; } description "The data modeling language the schema is written in (currently xsd, yang, yin, rng or rnc). For YANG data models, 'yang' format MUST be supported and 'yin' format MAY also be provided."; } leaf namespace { type inet:uri; description "The XML namespace defined by the data model. For YANG data models, this is the module's namespace. If the list entry describes a submodule, this field contains the namespace of the module to which the submodule belongs."; } leaf-list location { type union { type enumeration { enum "NETCONF"; } type inet:uri; } description Scott & Bjorklund Expires August 27, 2010 [Page 22] Internet-Draft YANG Module for NETCONF Monitoring February 2010 "One or more locations from which the schema can be retrieved. This list SHOULD contain at least one entry per schema. A schema entry may be located on a remote file system (eg: reference to file system for ftp retrieval) or retrieved directly from a server supporting the operation (denoted by the value 'NETCONF')."; } } } container sessions { description "The sessions container includes session specific data for NETCONF management sessions. The session list MUST include all currently active NETCONF sessions."; list session { key session-id; description "Unique identifier for the session. This value is the NETCONF session identifier, as defined in [RFC4741]. All NETCONF sessions managed by the NETCONF server SHOULD be reported in this table. Any sessions not managed by the NETCONF server with session identifier 0 MUST be excluded."; leaf session-id { type session-id; } leaf transport { type identityref { base transport; } mandatory true; description "Identifies the transport for each session, e.g. 'netconf-ssh', 'netconf-soap', etc."; } leaf username { type string; description "If present, the username contains an identifier which can be used to uniquely identify an individual client (human or machine). This is likely to be implementation specific Scott & Bjorklund Expires August 27, 2010 [Page 23] Internet-Draft YANG Module for NETCONF Monitoring February 2010 and subject to the security requirements of the device vendor and/or operators, e.g., an SSH user, a host RSA fingerprint or other identifier deemed acceptable."; } leaf source-host { type inet:host; description "Host identifier of the client. The value returned is likely to be implementation specific (e.g. hostname, IP v4 address, IP v6 address)"; } leaf login-time { type yang:date-and-time; mandatory true; description "Time at which the session was established."; } uses common-counters { description "Per-session counters. Zero based with following reset behaviour: - at start of a session - when max value is reached"; } } } container statistics { leaf netconf-start-time { type yang:date-and-time; description "Date and time at which the management subsystem was started."; } leaf in-bad-hellos { type yang:zero-based-counter32; description "Number of sessions silently dropped because an invalid message was received. This includes hello messages with a 'session-id' attribute, bad namespace, and bad capability declarations."; } leaf in-sessions { type yang:zero-based-counter32; description "Number of sessions started. This counter is incremented when a message with a is sent. Scott & Bjorklund Expires August 27, 2010 [Page 24] Internet-Draft YANG Module for NETCONF Monitoring February 2010 'in-sessions' - 'in-bad-hellos' = 'number of correctly started netconf sessions'"; } leaf dropped-sessions { type yang:zero-based-counter32; description "Number of sessions that were abnormally terminated, e.g. due to idle timeout or transport close. This counter is not incremented when a session is properly closed by a operation, or killed by a operation."; } uses common-counters { description "Global counters, accumulated from all sessions. Zero based with following reset behaviour: - re-initialization of NETCONF server - when max value is reached"; } } } rpc get-schema { description "This operation is used to retrieve a schema from the NETCONF server. Positive Response: The NETCONF server returns the requested schema. Negative Response: If requested schema does not exist, the is 'invalid-value'. If more than one schema matches the requested parameters, the is 'operation-failed', and is 'data-not-unique'."; input { leaf identifier { type string; mandatory true; description "Identifier for the schema list entry."; } leaf version { type string; description Scott & Bjorklund Expires August 27, 2010 [Page 25] Internet-Draft YANG Module for NETCONF Monitoring February 2010 "Version of the schema requested. If this parameter is not present, and more than one version of the schema exists on the server, a 'data-not-unique' error is returned, as described above."; } leaf format { type identityref { base schema-format; } description "The data modeling language of the schema. If this parameter is not present, and more than one formats of the schema exists on the server, a 'data-not-unique' error is returned, as described above."; } } output { anyxml data { description "Contains the schema content."; } } } } Scott & Bjorklund Expires August 27, 2010 [Page 26] Internet-Draft YANG Module for NETCONF Monitoring February 2010 6. Security Considerations The NETCONF monitoring data model as defined in this document provides information about a NETCONF system that could be used to aid an attack on that system. The same considerations as for the base [RFC4741] are valid. It is assumed that access to the data and operations defined in this document are subject to appropriate access control on the device. Scott & Bjorklund Expires August 27, 2010 [Page 27] Internet-Draft YANG Module for NETCONF Monitoring February 2010 7. Acknowledgements The authors would like to thank Andy Bierman, Mehmet Ersue, Washam Fan, David Harrington, Balazs Lengyel, Hideki Okita, Juergen Schoenwaelder, Bert Wijnen and many other members of the NETCONF WG for providing important input to this document. The authors would also like to specifically acknowledge Sharon Chisholm's work on 'draft-netconf-chisholm-monitoring-02' and contribution to this document. Scott & Bjorklund Expires August 27, 2010 [Page 28] Internet-Draft YANG Module for NETCONF Monitoring February 2010 8. IANA Considerations -- Editor note to IANA/RFC-Editor: we request that you make these assignments, in which case it is to be documented as below replacing 'rfcXXXX' as appropriate This document registers one URI in the IETF XML registry. Following the format in [RFC3688], the following registration is requested. URI: urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring Registrant Contact: The IESG. XML: N/A, the requested URI is an XML namespace. This document registers one YANG module in the YANG Module Names registry [RFC XXXX]. name: ietf-netconf-monitoring namespace: urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring:rfcXXXX prefix: ns reference: rfcXXXX Scott & Bjorklund Expires August 27, 2010 [Page 29] Internet-Draft YANG Module for NETCONF Monitoring February 2010 9. Appendix A - Change Log [-- Editor note to IANA/RFC-Editor: Please remove this section upon publication.] 9.1. draft-ietf-netconf-monitoring-12 - updated for AD review 9.2. draft-ietf-netconf-monitoring-11 Scott & Bjorklund Expires August 27, 2010 [Page 30] Internet-Draft YANG Module for NETCONF Monitoring February 2010 - updated URI and YANG module revision - updated sec 5 title to align with other text - updated Acknowledgements - added Description statements to identityrefs in the YANG module - updated document expiry - updated document title to v11 - sec 1.1: removed 'schema' definition; it will be placed in one of the base NETCONF documents instead (i.e. 4741bis) - sec 2: reworded 'The NETCONF monitoring data defined' to 'The NETCONF monitoring data model defined' - sec 2.1: reworded 'The /netcong-state subtree...' to 'The netconf-state container...' - sec 2.1: reworded 'List of NETCONF datastores...' to 'Includes all supported datastore types...' - sec 2.1: removed '(Container)' for consistency - sec 2.1.3: reworded format to remove file/module with schema - sec 2.1.3 reworded 'The data modeling language of the file/module...' to 'The data modeling language the schema is written in...' removing references to files/modules. - sec 2.1.3: reworded 'defined by the data model' to 'defined by the schema' - sec 2.1.3: reworded namespace from 'by the data model' to 'by the schema' - sec 2.1.4 changed '[NETCONF Configuration Protocol]' to '[RFC4741]' - sec 4.1 simplified wording in this section. Specifically removed the SHOULD and MUST statements which are already qualified in sec 2.1.3 and in YANG the module - sec 4.1 to address comment about lack of standardized sftp definition changed 'sftp' to 'ftp' and updated examples to use standardized ftp URI - sec 4.1 reworded 'data models' to 'schema' - sec 4.1 updated YANG example URI to use '@' instead of '-' - sec 4.2 updated YANG example URI to use '@' instead of '-' - YANG module, revision statement: changed RFC title to match draft name - YANG module, container netconf-state: updated description to match sec 2.1 - YANG module, container datastores: updated description - YANG module, list partial-locks: added reference to RFC5717 - YANG module,leaf-list locked-nodes: removed text which was inconsistent with partial lock RFC - YANG module, leaf format: updated description to match sec 2.1.3 - YANG module, container sessions: updated description to match sec 4.1 - YANG module, leaf source-host: updated description to clarify that identifier is likely to be implementation specific per sec 2 - References: moved YANG, Common Yang Data Types and XML from informative to normative - References: updated partial lock details to RFC5717 Scott & Bjorklund Expires August 27, 2010 [Page 31] Internet-Draft YANG Module for NETCONF Monitoring February 2010 9.3. draft-ietf-netconf-monitoring-10 - sec 1.1, updated schema definition, removed YANG definition (it is in references instead) - reworded text in Intro about NETCONF clients adjusting 'capabilities', per agreement that capacbilities can not change in a session (per 4741bis) - introduction, removed description of NETCONF behaviour for schema changes on active sesssions. Has been moved to 4741bis - updated namespace from '*:ns:netconf::state' to '*:yang:ns:ietf-netconf-monitoring:DRAFT-10' For details see ML archive: 'http://www.ietf.org/mail-archive/web/netconf/current/msg05296.html' - moved majority of sec 2 into the yang module (making module self describing), leaving only overview text in the RFC body. For details see ML archive: 'http://www.ietf.org/mail-archive/web/netconf/current/msg05209.html' - reworded definition of 'schema' - removed residual references to XSD types (i.e. xs:string) - reworded text that schema may not always be retrievable - will add additional text that yang format is both the default and mandatory; yin is optional - updated text per Juergen's WGLC comments on v09. For details see ML arhive: 'http://www.ietf.org/mail-archive/web/netconf/current/msg05306.html' - updated reference in sec 1.1 for RFC2119 - title change to 'YANG Module for NETCONF Monitoring' 9.4. draft-ietf-netconf-monitoring-09 - reversion of 'session-type' to 'transport' - element naming consistency. All lowerCamelCase names have been converted to 'hyphen-delimited' or 'netconf-style-naming' as it is sometimes referred to on the ML. E.g. 'sessionType' -> 'session-type'. This change impacts both the draft text and yang module. - <get-schema> operation updated: - now has only one mandatory parameter, 'identifier' - updated negative responses, including the rpc operation description in yang module - comments added to the yang module indicating that the definition of 'session-id' is consistent with 4741bis 'session-id-type' and could be imported from that pending RFC. Similar for 'netconf-datastore-type'. This was in favour of adding further Scott & Bjorklund Expires August 27, 2010 [Page 32] Internet-Draft YANG Module for NETCONF Monitoring February 2010 dependencies and delays by waiting for 4741bis to complete. 9.5. draft-ietf-netconf-monitoring-08 - Addresses action items from IETF75 and mailing list comments - Most significant is the decision to adopt YANG as normative As a result the publication of this draft depends on: o WGLC updates (if required) o updates to the normative model as result of netmod YANG changes (if required) o data organization changes if WG adopts a new data hierarchy for netmod (this draft uses "/netconf-state/") - XML Schema of model and IP host definition have been removed 9.6. draft-ietf-netconf-monitoring-07 - updates the examples in sec 4.2 per ML discussion 9.7. draft-ietf-netconf-monitoring-06 - replaced references to 'schema-retrieval capability' with '<get-schema> operation' - upper/lowercase alignment on references to 'format' - changed negative response for <get-schema> to 'data-missing' - ML comments on v05 which required changes in the draft: o 2.1.2: reworded to avoid suggestion that configurable data was contained in the sub-tree (per Balazs' request) o 2.1.2: reworded paragraph partial lock and select statements (per Balazs' suggested text) o Fixed examples in 3.1 and added negative response (per Balazs' comment) o YANG: location changed to leaf-list (per Balazs' comment) o added non-normative references to yang and yang-types (per Balazs' comment) o 2.1.3: added YIN and RNC to format 'enums' text and models 9.8. draft-ietf-netconf-monitoring-05 Scott & Bjorklund Expires August 27, 2010 [Page 33] Internet-Draft YANG Module for NETCONF Monitoring February 2010 This version addresses action items from IETF74 and comments on v4. - updated statistics (and counter definitions) per offline discussion: - updated counter definitions - updated data types (addition of ZeroBasedCounter32) - per session counters; see section 2.1.4 - global counters; see section 2.1.5 - unique sessionId handling and WG consensus: o expected handling of NETCONF and non-NETCONF sessions defined o explicit exclusion of sessionId=0 added o see section 2.1.4 - removal of subscriptions subtree; was sec 2.1.5 in v4 - revised XSD and YANG models 9.9. draft-ietf-netconf-monitoring-04 - New RPC operation defined <get-schema<, replacing <list-schema>. - Updated Abstract and Introduction: new text, removed NETCONF protocol diagram. - Changed /netconfstate/ to /netconf-state - Added netconf-state/datastores - Changed /netconf-state/schema to /netconf-state/schemas - Added /netconf-state/statistics - Added /schema/format (and added to key) - Added /schema/namespace (and added to key) - Updated examples. - More detailed monitored data descriptions per ML comments. 9.10. draft-ietf-netconf-monitoring-03 - incorporates ML list comments on v-02. 9.11. draft-ietf-netconf-monitoring-02 - Merged content from 'draft-scott-netconf-schema-query' into this draft - this draft now covers both schema retrievel and monitoring 9.12. draft-ietf-netconf-monitoring-01 Scott & Bjorklund Expires August 27, 2010 [Page 34] Internet-Draft YANG Module for NETCONF Monitoring February 2010 - WG first draft, 'draft-ietf-netconf-monitoring-01'. - Related draft 'draft-scott-netconf-schema-query-00' also presented covering schema retrieval. Query draft proposes new NETCONF operations to retrieve schema defined in this draft. 9.13. draft-scott-netconf-monitoring-00 - Initial draft, 'draft-scott-monitoring-00' - based on 'draft-netconf-chisholm-monitoring-02' - adopted as working group document at IETF69. Scott & Bjorklund Expires August 27, 2010 [Page 35] Internet-Draft YANG Module for NETCONF Monitoring February 2010 10. References 10.1. Normative References [Common YANG Data Types] Schoenwaelder, J., "Common YANG Data Types", June 2009, . [RFC2119] Bradner, s., ""Key words for use in RFCs to Indicate Requirement Levels", BCP 14", RFC 2119, March 1997, . [RFC4741] Enns, R., "NETCONF Configuration Protocol", RFC 4741, February 2006, . [RFC5717] Lengyel, Balazs., "Partial Lock Remote Procedure Call (RPC) for NETCONF", December 2009, . [XML] World Wide Web Consortium, "Extensible Markup Language (XML) 1.0", W3C XML, February 1998, . [YANG] Bjorklund, M., "YANG - A data modeling language for NETCONF", June 2009, . 10.2. Informative References [4741bis] Enns, R., Bjorklund, M., Schoenwaelder, J., and A. Bierman, "Network Configuration Protocol draft-ietf-netconf-4741bis-02", ID draft-ietf-netconf-notification-14, July 2008, . [ISO/IEC 19757-2:2008] ISO/IEC, "Document Schema Definition Language (DSDL) -- Part 2: Regular-grammar-based validation -- RELAX NG", December 2008, . [RFC3688] Mealling, M., "The IETF XML Registry", January 2004, . [RFC4742] Wasserman, M. and T. Goddard, "Using the NETCONF Configuration Protocol over Secure SHell (SSH)", December 2006, . Scott & Bjorklund Expires August 27, 2010 [Page 36] Internet-Draft YANG Module for NETCONF Monitoring February 2010 [RFC4743] Goddard, T., "Using NETCONF over the Simple Object Access Protocol (SOAP)", December 2006, . [RFC4744] Lear, E. and K. Crozier, "Using the NETCONF Protocol over the Blocks Extensible Exchange Protocol (BEEP)", December 2008, . [RFC5277] Chisholm, S. and H. Trevino, "NETCONF Event Notifications", ID draft-ietf-netconf-notification-14, July 2008, . [RFC5539] Badra, M., "NETCONF over Transport Layer Security (TLS)", May 2009, . [xmlschema-2] Biron, Paul V. and Ashok. Malhotra, "XML Schema Part 2: Datatypes Second Edition W3C Recommendation 28 October 2004", RFC 2119, October 2004, . Scott & Bjorklund Expires August 27, 2010 [Page 37] Internet-Draft YANG Module for NETCONF Monitoring February 2010 Authors' Addresses Mark Scott Ericsson 3500 Carling Ave Nepean, Ontario K2H 8E9 Canada Email: mark.scott@ericsson.com Martin Bjorklund Tail-f Systems Klara Norra Kyrkogata 31 SE-111 22 Stockholm, Sweden Email: mbj@tail-f.com Scott & Bjorklund Expires August 27, 2010 [Page 38]