120 likes | 146 Views
This document discusses the details and agenda of the NETCONF WG 68th IETF in Prague. It focuses on the Notification Draft and Create Subscription Issues, including namespace and data organization, event class issues, and replay issues.
E N D
NETCONF WG Details • Mailing List • Discussion: netconf@ops.ietf.org • Subscribe: netconf-request@ops.ietf.org • ‘subscribe’ in the message body • Archive: http://ops.ietf.org/lists/netconf/ • WG Chairs • Simon Leinen <simon@switch.ch> • Andy Bierman <ietf@andybierman.com> • WG Charter Page • http://www.ietf.org/html.charters/netconf-charter.html • WG Home Page • http://www.ops.ietf.org/netconf/
Agenda • WG Draft: • NETCONF Event Notificationsdraft-ietf-netconf-notification-06.txt • Agenda • NETCONF Notifications: Final WG Review • discuss WGLC mailing list comments • identify any remaining unresolved issues • discuss and resolve as many identified issues as possible
Notification Draft Status • 3 week WGLC completed March 16 • Several comments made (thanks) • Only minor issues remain • Expect next draft to be the final version submitted to IESG
Notification Manager Interface • Stream Discovery: • <get> of /ncn:eventStreams (namespace is TBD) • Start: • <create-subscription> • start receiving notification with or without replay • NETCONF stream used if none specified • specify optional filter or profile (i.e., stored filter) • Stop: • <kill-session> (from a different session) • drop transport connection (from same session) • Receive Notification: • <notification> • ‘replay complete’ is the only notification content defined
Namespace and Data Organization Issues • urn:ietf:params:xml:ns:netmod:event:1.0 • <eventStreams> element • <namedProfile> • <namedProfiles> (contains ref to <namedProfile>) • urn:ietf:params:xml:ns:netconf:notification:1.0 • <create-subscription> • <notification> • urn:ietf:params:xml:ns:netconf:replayNotification:1.0 • <replayCompleteNotification> • Seems to be WG consensus to have 1 XSD and NS • which target namespace? • Seems to be WG consensus for ‘foo-bar’ naming style instead of ‘fooBar’ style
Event Class Issues • Do we need to add this field to the Replay Complete notification? • This kind of field is a registry entry • registration type is OBJECT IDENTIFIER in SMIv2 • registration type is QName in XML • currently using string which allows naming collisions between vendors • same issue applies to <error-app-tag> in <rpc-error> • Don’t really want to start this registry and populat it, as part of the Notification (protocol) work • Propose leaving event class out of the Replay Complete notification
Create Subscription Issues • <create-subscription> RPC method • type: rpc method type extension (no issues) • content: stream, optional filter or profile (no issues) • error response: • new error codes not needed, use existing error-tag values • Is an <rpc-error> with a special warning about start and stop times that produce no output really needed? • documentation: • list RPC parameter names and data types here • should replay section text related to this RPC method be moved? Currently have partial documentation because of start-time and stop-time. • namespace URI: (ncn) • want 1 new namespace for all NETCONF Notification XML definitions
Notification Structure Issues • <notification> • currently defined with a mandatory <data> container like an <rpc-reply> • should this work like the <rpc> container instead? • NotificationType, like RpcOperationType, is the abstract base for notifications • Each notification defines its own FooNotificationType as an extension to NotificationType • Only the ‘notification type’ element is required to be present, like the ‘RPC method node’ element • Common ‘header’ fields that are approved later by the NETMOD WG (e.g., event-class and timestamps) can be added as attributes to the <notification> element in the future
Replay Issues • <replayCompleteNotification> • change name to <replay-complete> ? • change contents from (timestamp + counter) to empty? • send as first notification if all parameters well-formed, but no notifications selected? • What if valid start/stop times are in the future? • What if the time changes (e.g., daylight savings time)? • several boundary conditions to document • What if a timezone is specified but the agent does not have one set, or it is set differently?
Replay Complete Notification Issues CURRENT: <notification xmlns=“ncn”> <ReplayCompleteNotification xmlns=“replayNotification”> <event-class>informational</event-class> <timeGenerated>2007-03-19T18:42:00.000-01:00</timeGenerated> <numberEventsReplayed>7482</numberEventsReplayed> </ ReplayCompleteNotification> </notification> PROPOSED: <notification xmlns=“ncn”> <replay-complete xmlns=“ncn”/> (‘ncn’ only because in the same XSD) </notification>
Documentation Issues • Examples • Move examples section to a non-normative appendix • Fix examples and align naming style with NETCONF • Check XSD and examples with XSD validator • Add examples for <create-subscription> in that section • IANA Considerations section • namespace URI for NETCONF Notifications 1.0 • any other registry requests for IANA? • XSD Issues • Fix bugs, remove unused imports • Combine all 3 XSDs into 1 XSD • Use named, reusable <complexType> instead of unnamed <complexType> within an <element> decl