Re: [netmod] Rfc8407 - what does this text mean?

Andy Bierman <andy@yumaworks.com> Tue, 20 February 2024 17:19 UTC

Return-Path: <andy@yumaworks.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 11384C14F6F6 for <netmod@ietfa.amsl.com>; Tue, 20 Feb 2024 09:19:03 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -7.105
X-Spam-Level:
X-Spam-Status: No, score=-7.105 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=yumaworks.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id kB9aMd1ocX93 for <netmod@ietfa.amsl.com>; Tue, 20 Feb 2024 09:18:59 -0800 (PST)
Received: from mail-pg1-x52c.google.com (mail-pg1-x52c.google.com [IPv6:2607:f8b0:4864:20::52c]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 31146C14F68D for <netmod@ietf.org>; Tue, 20 Feb 2024 09:18:59 -0800 (PST)
Received: by mail-pg1-x52c.google.com with SMTP id 41be03b00d2f7-5ce2aada130so5037420a12.1 for <netmod@ietf.org>; Tue, 20 Feb 2024 09:18:59 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yumaworks.com; s=google; t=1708449538; x=1709054338; darn=ietf.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=n9CieZPXN2sKfFOD110AtWTcLGhAUSgb6+HCOBkKhNU=; b=EmqAtTimQRh6AGPjAeUa2o/GZRf7/1vySV3QsvG1UFmKUstP12qs7WPHSV6KBwcLQq IQT+9ikG/lrA97eaG0ea2BPAG3LnwjyZvCIJKsexj2HQsK6BNVM7zwIOmDT8yWnVjNPb 6WUEHg1c4ut4RxO9KJX6hpIyMeKIRaTDtv5JKnCjNwrc1mTmwV3iHL6IDKR7XDDPAoqt ahRjAnCjHTGusx9SgZ+yhIc3st8ECMJJAs56Y6X7HfrvNUFpjjmTFSVoERBG10dFlGk+ AKt0fM9HWPFFzBIr2tANIuL0X92ifmNVypb2D9JlTu6UVraAMOHsSyhGsB2Y8S1XHlVK leYg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1708449538; x=1709054338; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=n9CieZPXN2sKfFOD110AtWTcLGhAUSgb6+HCOBkKhNU=; b=Z/lPz0BtGQYvEqzU6I6fPAMqINcrqlo+O2cOW6kEIgAsUQLyhEIqF95Jeml9fvfluj L7V1Y4nEgIfhMRJNE8DzWgbi+MGGho6RU0wDTbuuIIg9L52Jc607X8fz4AnNAZERtL4U qLtD6nv8+cBlOJdIxvuKo7nDGuxtI6JfVpVHEOH3H25nNRQPvqbtYXrUTcBmuiVrgAcw C0uqcCUgOVlnW7ySbt7TsHz9hPRGStFgOUNqKH5V/SRafWxipf6+x8aXwdIoqTroGbg9 1w37KTIlis3qD0xrRwqGnQq+lEOXFCXdHc3HFq2Krttly0Ss15f0WBvULLwpbnK4KhWS 5INw==
X-Forwarded-Encrypted: i=1; AJvYcCVh+fi52IsJVSKRIOl8W1+R8l0SgcwS4A7XLZEudgzLtgFkptPdZAktIjsT7N//Ip5N4YCOe49c9K18LkBJwhk=
X-Gm-Message-State: AOJu0Yx/mK3s4KZp74+FQ/lchXvhOiIvTLE2F0BslXpKTF0WMJENxZKj Vf2WaHOi2FclHpV5fAW8+y2VOQv1MCv8sHo5Rn2s3jEL5Opg4Nsonn7Ce3XpvpdJxghseIvLOa5 +jUG2H9i3Wewl7AErX3OHeVVshGY/TTq0PbpApCgU7DZqsy5z1x8=
X-Google-Smtp-Source: AGHT+IH4FEtI+O6IXwvMhK9ENWdp0V1GmVaUHZPD2j3pyxmLqiK5C879r7U8MSHfmYF5N2vNpQOS7Pk2BnKlUPObQ7c=
X-Received: by 2002:a17:90a:bf83:b0:299:2240:43d with SMTP id d3-20020a17090abf8300b002992240043dmr10248164pjs.30.1708449538522; Tue, 20 Feb 2024 09:18:58 -0800 (PST)
MIME-Version: 1.0
References: <0100018db387ce0a-80850b96-bf6b-4978-afde-27d38f36bcd8-000000@email.amazonses.com> <CABCOCHQpvAwYbPyXqOW3P=4GWhCdWWmmKaQh4eubetSn0VMyLQ@mail.gmail.com> <0100018db3b387be-74bd44a5-35a1-463f-b787-84a2177c1800-000000@email.amazonses.com> <DU2PR02MB10160E3ED307A860258A8E28588512@DU2PR02MB10160.eurprd02.prod.outlook.com> <0100018dc1dc6029-466c9a12-e954-42e7-ab25-9d999aeeb360-000000@email.amazonses.com> <CABCOCHToJpJ0PEzMkaGKDKgoCL1n15HDAQW2-NoxMGLOxh5Qbw@mail.gmail.com> <DU2PR02MB1016071438155ADC0B35152F988502@DU2PR02MB10160.eurprd02.prod.outlook.com>
In-Reply-To: <DU2PR02MB1016071438155ADC0B35152F988502@DU2PR02MB10160.eurprd02.prod.outlook.com>
From: Andy Bierman <andy@yumaworks.com>
Date: Tue, 20 Feb 2024 09:18:47 -0800
Message-ID: <CABCOCHSqc-Lz=-wsZGEqQWHFc3yZSeuEhVthshmwrcrZOQVddA@mail.gmail.com>
To: mohamed.boucadair@orange.com
Cc: Kent Watsen <kent+ietf@watsen.net>, "netmod@ietf.org" <netmod@ietf.org>
Content-Type: multipart/alternative; boundary="000000000000dc5d1b0611d36797"
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/lE7YjOv6qpJ43vqSIVSaI17-ijQ>
Subject: Re: [netmod] Rfc8407 - what does this text mean?
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.39
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: Tue, 20 Feb 2024 17:19:03 -0000

On Mon, Feb 19, 2024 at 11:39 PM <mohamed.boucadair@orange.com> wrote:

> Hi all,
>
>
>
> I updated the PR to use a wording aligned with 4.23:
>
>
>
> NEW:
>
>    If the document contains a temporary non-NMDA (Network Management
>
>    Datastore Architecture) [RFC8342], then the Introduction section
>
>    should mention this fact with the reasoning that motivated that
>
>    design.  Refer to Section 4.23 for more NMDA-related guidance.
>
>
>


Does this mean that the Transition to NMDA is completed, and it is now
considered a bad idea
to include a non-NMDA 'state' module?  Most deployments (90%?) are non-NMDA.
The motivation will always be to allow this 90% to retrieve the operational
values of specific configuration data.

Cheers,
>
> Med
>
>
>

Andy


> *De :* Andy Bierman <andy@yumaworks.com>
> *Envoyé :* lundi 19 février 2024 19:58
> *À :* Kent Watsen <kent+ietf@watsen.net>
> *Cc :* BOUCADAIR Mohamed INNOV/NET <mohamed.boucadair@orange.com>;
> netmod@ietf.org
> *Objet :* Re: [netmod] Rfc8407 - what does this text mean?
>
>
>
>
>
>
>
> On Mon, Feb 19, 2024 at 6:54 AM Kent Watsen <kent+ietf@watsen.net> wrote:
>
> Hi Med,
>
>
>
> On Feb 19, 2024, at 3:29 AM, mohamed.boucadair@orange.com wrote:
>
>
>
> Hi Kent, all,
>
>
>
> I also think that highlighting the exceptions + motivate them makes sense
> here. A PR to fix that can be seen at [1].
>
>
>
> Thank you.
>
>
>
> I hope folks express objections now, before WGLC, as an expeditious
> resolution helps me close off an IESG review comment in NETCONF.
>
>
>
> Guidelines should be specific and clear.
>
> This inverse exception text seems better than the boilerplate text you
> want to replace.
>
>
>
> What exactly does it mean for a YANG module to be non-NMDA-compliant?
>
> Is the guideline forbidding config/state sibling containers, or just those
> that use a grouping or cut-and-paste
>
> to implement its non-NMDA-ness?
>
> Maybe NMDA experts can explain when this exception is needed and what it
> should say.
>
>
>
>
>
>
>
>
>
>
>
> FWIW, the OLD text was added draft-ietf-netmod-rfc6087bis-17 as per a
> comment in the AD review [2].
>
>
>
> That’s a great find!
>
>
>
>
>
> No wonder I didn't remember the WG discussing this during draft-8407.
>
>
>
>
>
> Cheers,
>
> Med
>
>
>
> K.
>
>
>
>
>
>
>
> Andy
>
>
>
>
>
>
>
> [1]
> https://author-tools.ietf.org/api/iddiff?url_1=https://boucadair.github.io/rfc8407bis/draft-ietf-netmod-rfc8407bis.txt&url_2=https://boucadair.github.io/rfc8407bis/nmda-exceptions/draft-ietf-netmod-rfc8407bis.txt
>
>
>
> [2]
> https://mailarchive.ietf.org/arch/msg/netmod/B4TUQZf7jud5wqrBwzEqEND6-rw/
>
>
>
>
>
> *De :* netmod <netmod-bounces@ietf.org> *De la part de* Kent Watsen
> *Envoyé :* vendredi 16 février 2024 21:55
> *À :* Andy Bierman <andy@yumaworks.com>
> *Cc :* netmod@ietf.org
> *Objet :* Re: [netmod] Rfc8407 - what does this text mean?
>
>
>
> Hi Andy,
>
>
>
> Thanks for the speedy reply.
>
>
>
> This guidance seems inverted, at least within the IETF (where SHOULDs are
> interpreted as MUSTs), and likely outside the IETF also, assuming rfc8407
> is read.  See the first paragraph of
> https://datatracker.ietf.org/doc/html/rfc8407#section-4.23.3
>
>
>
> I doubt any module would get past the IETF-publication process now if it
> defined a non-NMDA compliant structure (i.e., CF nodes that provide the
> opstate value for CT nodes), unless it was a “temporary non-NMDA module” (
> https://datatracker.ietf.org/doc/html/rfc8407#section-4.23.3.1).
>
>
>
> Since this, for awhile now, is the normal thing to do, the text
> highlighted in my OP seems to have little to no value.  That said, an
> “inverted” statement would have some value, that is, to explicitly
> highlight if the document defines any “temporary non-NMDA modules”.  This
> would be akin to highlighting when a document defines any IANA-maintained
> modules.
>
>
>
> I am proposing to update the text in rfc8407bis accordingly (to invert the
> guidance).  Thoughts?
>
>
>
> If there is agreement to update this text accordingly, I will delete the
> "Adherence to the NMDA” section in all my drafts, since none of them define
> a “temporary non-NMDA module”.
>
>
>
> PS: top-posting for simplicity
>
>
>
> K.
>
>
>
>
>
>
>
> On Feb 16, 2024, at 3:25 PM, Andy Bierman <andy@yumaworks.com> wrote:
>
>
>
>
>
>
>
> On Fri, Feb 16, 2024 at 12:07 PM Kent Watsen <kent+ietf@watsen.net> wrote:
>
> NETMOD,
>
>
>
> An IESG member reviewing one of my drafts flagged a section I had written
> to satisfy this text from
> https://datatracker.ietf.org/doc/html/rfc8407#section-3.5:
>
>
>
>        If the document contains a YANG module(s) that is compliant with
> NMDA
>
>        [RFC8342], then the Introduction section should mention this fact.
>
>
>
>        Example:
>
>
>
>          The YANG data model in this document conforms to the Network
>
>          Management Datastore Architecture defined in  RFC 8342.
>
>
>
>
>
> What does "compliant with NMDA” actually mean?   Are not all modules
> “compliant”, even if they unnecessarily define some opstate nodes?
>
>
>
>
>
> I do not recall the discussions that led to that text.
>
>
>
> Does this sentence actually point to if the document publishes any so
> called “-state” modules, defined only to support legacy “non-NMDA” servers?
>
>
>
>
>
> I think the state modules are optional, so it is still unclear what NMDA
> conformance means for a YANG module.
>
>
>
>
>
> Does it make sense to clarify this text, since rfc8407bis is an open WG
> document at the moment?
>
>
>
> maybe it means to follow all the guidelines in 4.23.3
>
> https://datatracker.ietf.org/doc/html/rfc8407#section-4.23.3
>
>
>
> maybe remove this other text you cite.
>
>
>
>
>
>
>
> Thanks,
>
> Kent
>
>
>
>
>
> Andy
>
>
>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod
>
>
>
> ____________________________________________________________________________________________________________
>
> Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
>
> pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
>
> a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
>
> Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.
>
>
>
> This message and its attachments may contain confidential or privileged information that may be protected by law;
>
> they should not be distributed, used or copied without authorisation.
>
> If you have received this email in error, please notify the sender and delete this message and its attachments.
>
> As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
>
> Thank you.
>
>
>
> ____________________________________________________________________________________________________________
> Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
> pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
> a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
> Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.
>
> This message and its attachments may contain confidential or privileged information that may be protected by law;
> they should not be distributed, used or copied without authorisation.
> If you have received this email in error, please notify the sender and delete this message and its attachments.
> As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
> Thank you.
>
>