Re: [netmod] I-D Action: draft-ietf-netmod-rfc6087bis-13.txt

2017-06-19 Thread Phil Shafer
Andy Bierman writes:
>This draft addresses all remaining open issues, include the rewrite of the
>opstate section.

>>In YANG, any data that has a "config" statement value of "false"
>>could be considered operational data.  The relationship between
>>configuration (i.e., "config" statement has a value of "true") and
>>operational data can be complex.

The NMDA draft includes the following in its terminology section:

  - configuration: Data that determines how a device behaves.  This
data is modeled in YANG using "config true" nodes.  Configuration
can originate from different sources.

  - operational state: The combination of applied configuration and
system state.

It would be nice to use matching terms, either by importing the
NMDA terms directly, or by mimicing them in this draft.  If your
"operational data" means "config false" and NMDA's "operational state"
means both config true and config false, readers will be confused.

Also you say "operational state and other data such as statistics"
which inconsisent.  Under either set of terms, statistics are
part of operational state.

>>The original set of datastores defined in NETCONF (i.e., candidate,
>>unning, and startup) are not sufficient to fully manage a device
>>ith multiple sources of configuration data.  In additional, a
>>separate datastore is needed to store operational state and other
>>data such as statistics.  Refer to
>>[I-D.ietf-netmod-revised-datastores] for details on this new "revised
>>datastore" architecture.  Guidelines for usage of the new datastores
>>(including the operational datastore) is defined in
>>[I-D.dsdt-nmda-guidelines].

"not sufficient to fully manage" is too broad a claim.  Can I suggest
a more positive spin:

  The Network Management Datastore Architecture (NMDA) defines a
  new set of datastores that improve visibility into the device,
  both in terms of the "intended" configurations values and the
  true operationally "in use" values.  Refer to
  [I-D.ietf-netmod-revised-datastores] for details.  Guidelines for
  moving existing data modules to the NMDA are defined in
  [I-D.dsdt-nmda-guidelines].

Thanks,
 Phil

___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod


Re: [netmod] I-D Action: draft-ietf-netmod-rfc6087bis-13.txt

2017-06-19 Thread Andy Bierman
Hi,

This draft addresses all remaining open issues, include the rewrite of the
opstate section.
I think it is ready for another quick WGLC and then back to the IESG.


Andy


On Sun, Jun 18, 2017 at 9:54 PM,  wrote:

>
> A New Internet-Draft is available from the on-line Internet-Drafts
> directories.
> This draft is a work item of the NETCONF Data Modeling Language of the
> IETF.
>
> Title   : Guidelines for Authors and Reviewers of YANG
> Data Model Documents
> Author  : Andy Bierman
> Filename: draft-ietf-netmod-rfc6087bis-13.txt
> Pages   : 64
> Date: 2017-06-18
>
> Abstract:
>This memo provides guidelines for authors and reviewers of Standards
>Track specifications containing YANG data model modules.  Applicable
>portions may be used as a basis for reviews of other YANG data model
>documents.  Recommendations and procedures are defined, which are
>intended to increase interoperability and usability of Network
>Configuration Protocol (NETCONF) and RESTCONF protocol
>implementations that utilize YANG data model modules.  This document
>obsoletes RFC 6087.
>
>
> The IETF datatracker status page for this draft is:
> https://datatracker.ietf.org/doc/draft-ietf-netmod-rfc6087bis/
>
> There are also htmlized versions available at:
> https://tools.ietf.org/html/draft-ietf-netmod-rfc6087bis-13
> https://datatracker.ietf.org/doc/html/draft-ietf-netmod-rfc6087bis-13
>
> A diff from the previous version is available at:
> https://www.ietf.org/rfcdiff?url2=draft-ietf-netmod-rfc6087bis-13
>
>
> Please note that it may take a couple of minutes from the time of
> submission
> until the htmlized version and diff are available at tools.ietf.org.
>
> Internet-Drafts are also available by anonymous FTP at:
> ftp://ftp.ietf.org/internet-drafts/
>
> ___
> I-D-Announce mailing list
> i-d-annou...@ietf.org
> https://www.ietf.org/mailman/listinfo/i-d-announce
> Internet-Draft directories: http://www.ietf.org/shadow.html
> or ftp://ftp.ietf.org/ietf/1shadow-sites.txt
>
___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod


Re: [netmod] Some comments on yang tree diagrams

2017-06-19 Thread Acee Lindem (acee)
Hi Michael, 

On 6/19/17, 3:20 AM, "netmod on behalf of wangzitao"
 wrote:

>Hi Authors,
>
>I have read this draft and think it is very useful. However, IMHO, there
>are also something need to improved. For example:
># In section2 Tree Diagram Syntax, it describes " !  for a presence
>container", but in some draft/ RFC the container not be marked by "!",
>for example "ietf-interface" [RFC7223].
># And I suggest to highlight the symbol "-w",

How do you highlight a symbol in plain ASCII text?

Thanks,
Acee 

>it usually appears in "input" of RPC, for example "ietf-yang-push"
>[draft-ietf-netconf-yang-push]
>
>Please consider my suggestion.
>
>Best Regards!
>-Michael
>
>-邮件原件-
>发件人: netmod [mailto:netmod-boun...@ietf.org] 代表 internet-dra...@ietf.org
>发送时间: 2017年6月13日 20:34
>收件人: i-d-annou...@ietf.org
>抄送: netmod@ietf.org
>主题: [netmod] I-D Action: draft-ietf-netmod-yang-tree-diagrams-00.txt
>
>
>A New Internet-Draft is available from the on-line Internet-Drafts
>directories.
>This draft is a work item of the NETCONF Data Modeling Language of the
>IETF.
>
>Title   : YANG Tree Diagrams
>Authors : Martin Bjorklund
>  Lou Berger
>   Filename: draft-ietf-netmod-yang-tree-diagrams-00.txt
>   Pages   : 4
>   Date: 2017-06-13
>
>Abstract:
>   This document captures the current syntax used in YANG module Tree
>   Diagrams.  The purpose of the document is to provide a single
>   location for this definition.  This syntax may be updated from time
>   to time based on the evolution of the YANG language.
>
>
>The IETF datatracker status page for this draft is:
>https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-tree-diagrams/
>
>There are also htmlized versions available at:
>https://tools.ietf.org/html/draft-ietf-netmod-yang-tree-diagrams-00
>https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-tree-diagrams
>-00
>
>
>Please note that it may take a couple of minutes from the time of
>submission until the htmlized version and diff are available at
>tools.ietf.org.
>
>Internet-Drafts are also available by anonymous FTP at:
>ftp://ftp.ietf.org/internet-drafts/
>
>___
>netmod mailing list
>netmod@ietf.org
>https://www.ietf.org/mailman/listinfo/netmod
>___
>netmod mailing list
>netmod@ietf.org
>https://www.ietf.org/mailman/listinfo/netmod

___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod


[netmod] Some comments on yang tree diagrams

2017-06-19 Thread wangzitao
Hi Authors,

I have read this draft and think it is very useful. However, IMHO, there are 
also something need to improved. For example:
# In section2 Tree Diagram Syntax, it describes " !  for a presence container", 
but in some draft/ RFC the container not be marked by "!", for example 
"ietf-interface" [RFC7223].
# And I suggest to highlight the symbol "-w", it usually appears in "input" of 
RPC, for example "ietf-yang-push" [draft-ietf-netconf-yang-push]

Please consider my suggestion.

Best Regards!
-Michael

-邮件原件-
发件人: netmod [mailto:netmod-boun...@ietf.org] 代表 internet-dra...@ietf.org
发送时间: 2017年6月13日 20:34
收件人: i-d-annou...@ietf.org
抄送: netmod@ietf.org
主题: [netmod] I-D Action: draft-ietf-netmod-yang-tree-diagrams-00.txt


A New Internet-Draft is available from the on-line Internet-Drafts directories.
This draft is a work item of the NETCONF Data Modeling Language of the IETF.

Title   : YANG Tree Diagrams
Authors : Martin Bjorklund
  Lou Berger
Filename: draft-ietf-netmod-yang-tree-diagrams-00.txt
Pages   : 4
Date: 2017-06-13

Abstract:
   This document captures the current syntax used in YANG module Tree
   Diagrams.  The purpose of the document is to provide a single
   location for this definition.  This syntax may be updated from time
   to time based on the evolution of the YANG language.


The IETF datatracker status page for this draft is:
https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-tree-diagrams/

There are also htmlized versions available at:
https://tools.ietf.org/html/draft-ietf-netmod-yang-tree-diagrams-00
https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-tree-diagrams-00


Please note that it may take a couple of minutes from the time of submission 
until the htmlized version and diff are available at tools.ietf.org.

Internet-Drafts are also available by anonymous FTP at:
ftp://ftp.ietf.org/internet-drafts/

___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod
___
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod