--- 1/draft-ietf-netconf-notification-10.txt 2007-11-12 20:12:07.000000000 +0100 +++ 2/draft-ietf-netconf-notification-11.txt 2007-11-12 20:12:07.000000000 +0100 @@ -1,18 +1,19 @@ + Network Working Group S. Chisholm Internet-Draft Nortel Intended status: Standards Track H. Trevino -Expires: April 19, 2008 Cisco - October 17, 2007 +Expires: May 14, 2008 Cisco + November 11, 2007 NETCONF Event Notifications - draft-ietf-netconf-notification-10.txt + draft-ietf-netconf-notification-11.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 @@ -23,21 +24,21 @@ 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 19, 2008. + This Internet-Draft will expire on May 14, 2008. Copyright Notice Copyright (C) The IETF Trust (2007). Abstract This document defines mechanisms that provide an asynchronous message notification delivery service for the NETCONF protocol. This is an optional capability built on top of the base NETCONF definition. @@ -85,20 +86,21 @@ 6.4. New Operations . . . . . . . . . . . . . . . . . . . . . . 35 6.5. Modifications to Existing Operations . . . . . . . . . . . 35 7. Security Considerations . . . . . . . . . . . . . . . . . . . 36 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 37 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 38 10. Normative References . . . . . . . . . . . . . . . . . . . . . 39 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 40 A.1. Version -08 . . . . . . . . . . . . . . . . . . . . . . . 40 A.2. Version -09 . . . . . . . . . . . . . . . . . . . . . . . 42 A.3. Version -10 . . . . . . . . . . . . . . . . . . . . . . . 44 + A.4. Version -11 . . . . . . . . . . . . . . . . . . . . . . . 44 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 45 Intellectual Property and Copyright Statements . . . . . . . . . . 46 1. Introduction [NETCONF] can be conceptually partitioned into four layers: Layer Example +-------------+ +-------------------------------------------+ | Content | | Configuration data | @@ -348,21 +350,21 @@ out of range, pattern mismatch. 2.1.1.1. Usage Example The following demonstrates creating a simple subscription. More complex examples can be found in section 5. + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> 2.2. Sending Event Notifications Once the subscription has been set up, the NETCONF server sends the event notifications asynchronously over the connection. 2.2.1. @@ -690,41 +692,41 @@ This Schema is used to learn about the event streams supported on the system. It also contains the definition of the and notifications, which are sent to indicate that an event replay has sent all applicable notifications and that the subscription has terminated, respectively. A schema that can be used to learn about current event streams. It also contains the replayComplete and notificationComplete notification. @@ -1118,24 +1120,24 @@ state. Examples in this section are generated from the following fictional Schema. + xmlns:ncEvent="urn:ietf:params:xml:ns:netconf:notification:1.0"> @@ -1158,57 +1160,57 @@ type="eventType" substitutionGroup="ncEvent:notificationContent"/> The above fictional notification definition could result in the following is a sample notification list, which is used in the examples in this section. + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> 2007-07-08T00:01:00Z fault Ethernet0 major + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> 2007-07-08T00:02:00Z fault Ethernet2 critical + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> 2007-07-08T00:04:00Z fault ATM1 minor + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> 2007-07-08T00:10:00Z state Ethernet0 enabled @@ -1225,21 +1227,21 @@ The following example illustrates how to select fault events which have severities of critical, major, or minor. The filtering criteria evaluation is as follows: ((fault & severity=critical) | (fault & severity=major) | (fault & severity=minor)) + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> fault critical fault major @@ -1252,21 +1254,21 @@ The following example illustrates how to select state or config EventClasses or fault events that are related to card Ethernet0. The filtering criteria evaluation is as follows: ( state | config | ( fault & ( card=Ethernet0))) + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> state config fault @@ -1282,54 +1284,54 @@ The following [XPATH] example illustrates how to select fault EventClass notifications that have severities of critical, major, or minor. The filtering criteria evaluation is as follows: ((fault) & ((severity=critical) | (severity=major) | (severity = minor))) + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> The following example illustrates how to select state and config EventClasses or fault events of any severity that come from card Ethernet0. The filtering criteria evaluation is as follows: ( state | config | (fault & card=Ethernet0)) + xmlns="urn:ietf:params:xml:ns:netconf:notification:1.0"> 6. Interleave Capability 6.1. Description The Interleave capability indicates that the NETCONF peer supports the ability to interleave other NETCONF operations within a - Notification subscription. This means the NETCONF server is able to + Notification subscription. This means the NETCONF server MUST receive, process and respond to NETCONF requests on a session with an active notification subscription. 6.2. Dependencies This capability is dependant on the notification capability being supported. 6.3. Capability Identifier @@ -1346,21 +1348,21 @@ When a is sent while another subscription is active on that session, the following error will be returned: Tag: operation-failed Error-type: protocol Severity: error - Error-info: : startTime + Error-info: none Description: Request could not be completed because the requested operation failed for some reason not covered by any other error condition. 7. Security Considerations The security considerations from the base [NETCONF] document also apply to the Notification capability. @@ -1679,20 +1681,29 @@ future. 2. Added interleave capability 3. Clarified create-subscription error messages. 4. Corrected targetNamespace in Netconf Notification XSD 5. Fixed typos and made minor edits. +A.4. Version -11 + + 1. Fixed namespaces + + 2. In section 6.5, fixed error message Error-info + + 3. In section 6.1 clarify that if the interleave capability is + supported, then the server must respond to requests. + Authors' Addresses Sharon Chisholm Nortel 3500 Carling Ave Nepean, Ontario K2H 8E9 Canada Email: schishol@nortel.com