[netmod] missing sections

Phil Shafer <phil@juniper.net> Wed, 10 March 2010 20:04 UTC

Return-Path: <phil@juniper.net>
X-Original-To: netmod@core3.amsl.com
Delivered-To: netmod@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 261D03A6915 for <netmod@core3.amsl.com>; Wed, 10 Mar 2010 12:04:09 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.599
X-Spam-Level:
X-Spam-Status: No, score=-6.599 tagged_above=-999 required=5 tests=[BAYES_00=-2.599, RCVD_IN_DNSWL_MED=-4]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id jIU+T8543k-H for <netmod@core3.amsl.com>; Wed, 10 Mar 2010 12:04:08 -0800 (PST)
Received: from exprod7og125.obsmtp.com (exprod7og125.obsmtp.com [64.18.2.28]) by core3.amsl.com (Postfix) with ESMTP id 1D24D3A68E7 for <netmod@ietf.org>; Wed, 10 Mar 2010 12:04:08 -0800 (PST)
Received: from source ([66.129.224.36]) (using TLSv1) by exprod7ob125.postini.com ([64.18.6.12]) with SMTP ID DSNKS5f7PPhDQPs/mKk2a/ilCbhwXYkcc6Wj@postini.com; Wed, 10 Mar 2010 12:04:13 PST
Received: from p-emfe01-sac.jnpr.net (66.129.254.72) by P-EMHUB01-HQ.jnpr.net (172.24.192.35) with Microsoft SMTP Server id 8.1.393.1; Wed, 10 Mar 2010 12:01:44 -0800
Received: from p-emlb01-sac.jnpr.net ([66.129.254.46]) by p-emfe01-sac.jnpr.net with Microsoft SMTPSVC(6.0.3790.3959); Wed, 10 Mar 2010 12:01:43 -0800
Received: from emailsmtp56.jnpr.net ([172.24.60.77]) by p-emlb01-sac.jnpr.net with Microsoft SMTPSVC(6.0.3790.3959); Wed, 10 Mar 2010 12:01:43 -0800
Received: from magenta.juniper.net ([172.17.27.123]) by emailsmtp56.jnpr.net with Microsoft SMTPSVC(6.0.3790.3959); Wed, 10 Mar 2010 12:01:43 -0800
Received: from idle.juniper.net (idleski.juniper.net [172.25.4.26]) by magenta.juniper.net (8.11.3/8.11.3) with ESMTP id o2AK1gD80248 for <netmod@ietf.org>; Wed, 10 Mar 2010 12:01:42 -0800 (PST) (envelope-from phil@juniper.net)
Received: from idle.juniper.net (localhost [127.0.0.1]) by idle.juniper.net (8.14.3/8.14.3) with ESMTP id o2AJjUmb074378 for <netmod@ietf.org>; Wed, 10 Mar 2010 19:45:30 GMT (envelope-from phil@idle.juniper.net)
Message-ID: <201003101945.o2AJjUmb074378@idle.juniper.net>
To: netmod@ietf.org
Date: Wed, 10 Mar 2010 14:45:30 -0500
From: Phil Shafer <phil@juniper.net>
X-OriginalArrivalTime: 10 Mar 2010 20:01:43.0575 (UTC) FILETIME=[81996A70:01CAC08C]
MIME-Version: 1.0
Content-Type: text/plain
Subject: [netmod] missing sections
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/netmod>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 10 Mar 2010 20:04:09 -0000

There were two sections in the last arch draft that were missing.
See the attached delta for the new text.  Unfortunately I cannot
post a new draft.

Thanks, 
 Phil

------

 ** Modeler
 
-(No clue what needs said here; lots to say, but what's important?)
+The modeler's role constructing a model based on their in-depth
+knowledge of the problem domain being modeled.  This model should
+be as simple as possible, but should balance complexity with
+expressiveness.  The organization of the model should target not only
+the current model, but should allow for extensibility from other
+modules and for adaptability to future changes.
 
 Additional modeling issues are discussed in ^modeling^.
 
@@ -680,8 +684,50 @@
 
 ** Default Values
 
-(With all the discussion on this point, it needs to be mentioned here.)
+The concept of default values is simple, but their details,
+representation, and interaction with configuration data can be
+difficult issues.  NETCONF leaves default values as a data model
+issue, and YANG gives flexibility to the device implementation in
+terms of how default values are handled.  The requirement is that the
+device "MUST operationally behave as is if the leaf was present in the
+data tree with the default value as its value".  This gives the device
+implementation choices in how default values are handled.
 
+One choice is to view the configuration as a set of instructions for
+how the device should be configured.  If a data value is given as part
+of those instructions is the default value, then it should be retained
+as part of the configuration, but if it not explicitly given, then the
+value is not considered to be part of configuration.
+
+Another choice is to trim values that are identical to the default
+values, implicitly removing them from the configuration database.
+The act of setting a leaf to it's default value effectively deletes
+that leaf.
+
+The device could also choose to report all default values, regardless
+of whether they were explicitly set.  This choice eases the work of
+a client that needs default values, but may significantly increase the
+size of the configuration data.
+
+These choices reflect the default handling schemes of widely deployed
+networking devices and supporting them allows YANG to reduce
+implementation and deployment costs of YANG-based models.
+
+When the client retrieves data from the device, it must be prepared to
+handle the absence of leaf nodes with the default value, since the
+server is not required to send such leaf elements.  This permits the
+device to implement either of the first two default handling schemes
+given above.
+
+Regardless of the implementation choice, the device can support the
+"with-defaults" capability (^RFCWITHDEFAULTS^) and give the client the
+ability to select the desired handling of default values.
+
+When evaluating the XPath expressions for constraints like "must" and
+"when", the evaluation context for the expressions will include any
+appropriate default values, so the modeler can depend on consistent
+behavior from all devices.
+