Re: [netmod] Fwd: Re: YANG schema mount - any early implementations?

Martin Bjorklund <mbj@tail-f.com> Mon, 06 August 2018 11:06 UTC

Return-Path: <mbj@tail-f.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9F5AB130EB7 for <netmod@ietfa.amsl.com>; Mon, 6 Aug 2018 04:06:33 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.901
X-Spam-Level:
X-Spam-Status: No, score=-1.901 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_PASS=-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 P6F9Q4YTXstL for <netmod@ietfa.amsl.com>; Mon, 6 Aug 2018 04:06:31 -0700 (PDT)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id F0057130DE2 for <netmod@ietf.org>; Mon, 6 Aug 2018 04:06:30 -0700 (PDT)
Received: from localhost (unknown [173.38.220.61]) by mail.tail-f.com (Postfix) with ESMTPSA id DE4DD1AE0141; Mon, 6 Aug 2018 13:06:29 +0200 (CEST)
Date: Mon, 06 Aug 2018 13:06:29 +0200
Message-Id: <20180806.130629.1938294228104902998.mbj@tail-f.com>
To: Hayden.Brown@Aviatnet.com
Cc: netmod@ietf.org
From: Martin Bjorklund <mbj@tail-f.com>
In-Reply-To: <1533552073111.98355@Aviatnet.com>
References: <5df7eb40589d4631a33c704358bc8f8e@USP-EXCHPROD01.GNET.global.vpn> <a6ad2e01-48e6-455a-7bbc-6ac5f58b9e07@labn.net> <1533552073111.98355@Aviatnet.com>
X-Mailer: Mew version 6.7 on Emacs 24.5 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset="utf-8"
Content-Transfer-Encoding: base64
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/EIKwOR50FNaT04WVgpgXMGzWyK8>
Subject: Re: [netmod] Fwd: Re: YANG schema mount - any early implementations?
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.27
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/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: Mon, 06 Aug 2018 11:06:33 -0000

Hi,

Hayden Brown <Hayden.Brown@Aviatnet.com> wrote:
> ​Hi Lou,
> 
> 
> Thank you for your response. In the new copy of the sections below I've attempted to convey how I think the paragraphs could read.
> 
> 
> In my mind, the main "point of ambiguity" is that it seemed the existing wording implies:
> 
>   *   ​ the mount-point list specifies which modules are mounted below the root of the mount point.
> 
> however, I think we have all agreed that:
> 
>   *   ​the mo​unt-point list specifies the parent module that contains the mount-point,.
> 
> I see this as just a subtle interpretation difference in the wording "specifies the mounted schema".
> 
> 
> 
> Hopefully the wording (edited in the brackets) below better conveys my thoughts. Please feel free to correct me, or improve the wording below as you see fit.
> 
> Section 3.3 – Page 7
> > The "/schema-mounts" container has the "mount-point" list as one of its children. Every entry of this list refers through its key to a mount point and specifies the [type of] mounted schema [as "inline" or "shared-schema"].
> 
> Section 3.3 - Page 8
> > An entry of the "mount-point" list can specify the [type of] mounted schema in two different ways, "inline" or "shared-schema".

The document does not define the "type" of a mounted schema, so I
don't think we should use that term in just a few places.

> Section 9 - Page 13
> > A mount point defines a place in the node hierarchy where other data models may be attached. A server that implements a module with a mount point populates the /schema-mounts/mount-point list with detailed information on whether the [data models mounted at each instance of a mount point MAY be different ("inline" case) or MUST all have the same YANG library checksum ("shared-schema" case).
> 
> For a "shared-schema" mount-point list entry, the entry MAY include one or more "parent-reference" list entries that are used to specify the context nodeset for any XPath 1.0 expressions defined within the mounted schema.]
> 
> 
> Section 9 - Page 14
> list mount-point {
>     key "module label";
>     description
>     "Each entry of this list specifies [the type of] schema for a particular mount point [ ("inline" or "shared-schema") ].
> 
> 
> Thanks and best regards,
> 
> Hayden
> 


/martin



> 
> 
> 
> 
> ________________________________
> From: Lou Berger <lberger@labn.net>
> Sent: Friday, 3 August 2018 7:28 a.m.
> To: Hayden Brown; netmod@ietf.org
> Subject: EXTERNAL: Re: [netmod] Fwd: Re: YANG schema mount - any early implementations?
> 
> 
> Hi,
> 
>     hopefully others will chime in too, but here's my view (as a user of schema mount, see https://tools.ietf.org/html/draft-ietf-rtgwg-ni-model)...
> 
> On 7/30/2018 7:27 PM, Hayden Brown wrote:
> 
> Hi everyone,
> 
> I just wanted to ask if it would be possible to clarify the intentions around some of the wording of the draft schema mount standard (Rev-10). In particular, regarding entries of the /schema-mounts/mount-points list.
> 
> My interpretation is that the intended use of the /schema-mounts/mount-points list entries are to specify the parent modules that contain a mount point.
> 
> yes
> 
> Following on from this, the client should use the YANG library instance to determine which schema options can be mounted at the root of a mount point. This seems consistent with the examples of Appendix A of the draft standard.
> 
> if you drop the word "options", then yes.  Other examples can be found in draft-ietf-rtgwg-ni-model
> 
> 
> In this email I wanted to highlight the following sections of the draft RFC below. In my view they seem to me to be somewhat ambiguous, in implying that the mount-point list entries specify the *child* module (sub-schema):
> 
> 
> >From https://datatracker.ietf.org/doc/draft-ietf-netmod-schema-mount/?include_text=1
> Section 3.3 – Page 7
> > The "/schema-mounts" container has the "mount-point" list as one of its children. Every entry of this list refers through its key to a mount point and specifies the mounted schema.
> 
> Section 3.3 - Page 8
> > An entry of the "mount-point" list can specify the mounted schema in two different ways, "inline" or "shared-schema".
> 
> 
> Section 9 - Page 13
> > A mount point defines a place in the node hierarchy where other data models may be attached. A server that implements a module with a mount point populates the /schema-mounts/mount-point list with detailed information on which data models are mounted at each mount point.
> 
> Section 9 - Page 14
> list mount-point {
>     key "module label";
>     description
>     "Each entry of this list specifies a schema for a particular mount point.
> 
> 
> I have reread the a few times and am having a hard time understand what should be changed.  Can you suggest specific changes that would address your concern/comment?  This might help to understand the issue you are seeing.
> 
> 
> The wording makes me wonder if these passages might actually just be "left-over" context from earlier revisions of the draft standard (Revision 8 and prior) -- effectively referring back to the schema-mount 'use-schema' list.
> 
> Again, I'm seeing the issue.
> 
> 
> I do of course acknowledge that it is entirely possible that I've misinterpreted the wording of the passages above, however if that is the case, I suspect I may not be the only one in future.
> And I'm sure I'm suffering from having spent way too much time on this topic so may be seeing things in the text that aren't actually there!
> 
> Cheers,
> Lou
> (no hats)
> 
> 
> Many thanks for your time on this matter.
> 
> Best regards,
> Hayden
> 
> 
> 
> 
> 
> 
> 
> On 20/07/2018 8:09 PM, Juergen Schoenwaelder wrote:
> 
> On Wed, Jul 11, 2018 at 09:43:32AM +1200, hayden wrote:
> 
> 
> 
> I understand that the schema mount proposal is still effectively in a
> 
> state of flux, but are there any publicly visible implementations or
> 
> deployments of a NETCONF or RESTCONF server that those interested could
> 
> experiment with (e.g. to aid in client development)?
> 
> 
> 
> State of flux? It is past WG last call and IETF last call.
> 
> 
> 
> https://datatracker.ietf.org/doc/draft-ietf-netmod-schema-mount/history/
> 
> 
> 
> /js
> 
> 
> 
> 
> 
> 
> 
> _______________________________________________
> netmod mailing list
> netmod@ietf.org<mailto:netmod@ietf.org>
> https://www.ietf.org/mailman/listinfo/netmod
> 
>