Re: [Netconf] nmda-restconf operations (was: netconf-binary-encoding comments)

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Tue, 10 July 2018 11:37 UTC

Return-Path: <j.schoenwaelder@jacobs-university.de>
X-Original-To: netconf@ietfa.amsl.com
Delivered-To: netconf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 2309F130E6F; Tue, 10 Jul 2018 04:37:43 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id tfqzHF0_L5KY; Tue, 10 Jul 2018 04:37:40 -0700 (PDT)
Received: from anna.localdomain (anna.eecs.jacobs-university.de [IPv6:2001:638:709:5::7]) by ietfa.amsl.com (Postfix) with ESMTP id AD752130E3C; Tue, 10 Jul 2018 04:37:40 -0700 (PDT)
Received: by anna.localdomain (Postfix, from userid 501) id 7445222FEA30; Tue, 10 Jul 2018 13:37:38 +0200 (CEST)
Date: Tue, 10 Jul 2018 13:37:38 +0200
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Robert Wilton <rwilton@cisco.com>
Cc: Kent Watsen <kwatsen@juniper.net>, "draft-ietf-netconf-nmda-restconf@ietf.org" <draft-ietf-netconf-nmda-restconf@ietf.org>, "netconf@ietf.org" <netconf@ietf.org>, Qin Wu <bill.wu@huawei.com>, Andy Bierman <andy@yumaworks.com>
Message-ID: <20180710113738.2bh6nrnxj35ew6z4@anna.jacobs.jacobs-university.de>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: Robert Wilton <rwilton@cisco.com>, Kent Watsen <kwatsen@juniper.net>, "draft-ietf-netconf-nmda-restconf@ietf.org" <draft-ietf-netconf-nmda-restconf@ietf.org>, "netconf@ietf.org" <netconf@ietf.org>, Qin Wu <bill.wu@huawei.com>, Andy Bierman <andy@yumaworks.com>
References: <82A8420F-445C-42BD-9A47-DCF62A9864BC@juniper.net> <20180709173041.xkihqyccjcucjslj@anna.jacobs.jacobs-university.de> <13FABA4A-C367-4E27-88FF-3EA48638249F@juniper.net> <20180709181338.anv7tfsylvhypwdz@anna.jacobs.jacobs-university.de> <56fa68dd-09a0-fe34-b331-345c13c75925@cisco.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <56fa68dd-09a0-fe34-b331-345c13c75925@cisco.com>
User-Agent: NeoMutt/20180622
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/EWGbE9G1sbQ63dutrUa-vK-spF8>
Subject: Re: [Netconf] nmda-restconf operations (was: netconf-binary-encoding comments)
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.27
Precedence: list
List-Id: Network Configuration WG mailing list <netconf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netconf>, <mailto:netconf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netconf/>
List-Post: <mailto:netconf@ietf.org>
List-Help: <mailto:netconf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netconf>, <mailto:netconf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 10 Jul 2018 11:37:44 -0000

On Tue, Jul 10, 2018 at 11:43:08AM +0100, Robert Wilton wrote:
> 
> 
> On 09/07/2018 19:13, Juergen Schoenwaelder wrote:
> > On Mon, Jul 09, 2018 at 05:48:57PM +0000, Kent Watsen wrote:
> > > 
> > > > > This isn't what I meant.  To be more specific, I'm wondering if the nmda-restconf
> > > > > draft would benefit from having a sentence like:
> > > > > 
> > > > >     A RESTCONF server supporting NMDA datastores MAY implement the
> > > > >     "ietf-netconf" [RFC6241] and "ietf-netconf-nmda" [I-D. ietf-netconf-nmda-
> > > > >     netconf] modules to enable the NETCONF operations defined in those
> > > > >     drafts to appear {+restconf}/operations resource.
> > > > > 
> > > > > Note: I put "MAY" as RESTCONF may someday have a more native way to do this.
> > > > > 
> > > > Well, "ietf-netconf" does not really support NMDA well and this is why
> > > > we have "ietf-netconf-nmda". Does not make much sense to point to
> > > > "ietf-netconf" in an NMDA document.
> > > But we'd still need lock, unlock, commit, commit-confirmed, etc., right?
> > Yep.
> OK.  Just to check - the client can determine which of these operations are
> supported via the feature statements in ietf-netconf.yang and the
> corresponding module entry in YANG library bis?

The YANG module ietf-netconf is at the end nothing special. So clients
should treat it like any other module. If the yang-library says this
module is implemented, then it is implemented and features will work
exactly like they work for any other module.

> > > Maybe it's a moot point, since ietf-netconf-nmda requires that ietf-netconf
> > > is implemented too, but I thought being explicit would be helpful here.
> > As long as readers get the idea that implementing lets say edit-config
> > is perhaps not the best idea...
> It might be a good idea to explicitly list the NETCONF operations that are
> not well defined and hence SHOULD NOT be implemented.

It is risky to repeat what other documents already discuss since doing
so raises the risks of producing inconsistencies and it may create
additional headaches when document updates are made later on.

Note that draft-ietf-netconf-nmda-netconf-06 also extends <lock> and
<unlock> to handle NMDA datastores. I think a pointer to this I-D is
relevant, I am less sure about ietf-netconf. Someone implementing
<candidate> likely figures out that without implement <commit>, this
<candidate> datastore is not very usable.

/js

-- 
Juergen Schoenwaelder           Jacobs University Bremen gGmbH
Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
Fax:   +49 421 200 3103         <https://www.jacobs-university.de/>