Re: [netmod] Fwd: New Version Notification for draft-ietf-netmod-yang-instance-file-format-00.txt

Balázs Lengyel <balazs.lengyel@ericsson.com> Fri, 23 November 2018 12:48 UTC

Return-Path: <balazs.lengyel@ericsson.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 271E412958B for <netmod@ietfa.amsl.com>; Fri, 23 Nov 2018 04:48:47 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.058
X-Spam-Level:
X-Spam-Status: No, score=-4.058 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-1.46, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FROM_EXCESS_BASE64=0.979, HTML_MESSAGE=0.001, MIME_HTML_ONLY=0.723, RCVD_IN_DNSWL_MED=-2.3, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=ericsson.com header.b=Rjy2K1Tu; dkim=pass (1024-bit key) header.d=ericsson.com header.b=UvSBwQfp
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 6r29gJ05Wp5a for <netmod@ietfa.amsl.com>; Fri, 23 Nov 2018 04:48:44 -0800 (PST)
Received: from sesbmg22.ericsson.net (sesbmg22.ericsson.net [193.180.251.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 04756124D68 for <netmod@ietf.org>; Fri, 23 Nov 2018 04:48:43 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; d=ericsson.com; s=mailgw201801; c=relaxed/simple; q=dns/txt; i=@ericsson.com; t=1542977322; x=1545569322; h=From:Sender:Reply-To:Subject:Date:Message-ID:To:Cc:MIME-Version:Content-Type: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=D/q1CEejpDBSqxmeUnNVR1vLAaXpQMamSZl4LgGZIyM=; b=Rjy2K1Tuxs2ybKbqSYmu+DfxT6Vzc3c0eRNIbp6XYVn0YrMcbASkZXTJSpEGK2FP AhSjH6+BnYZkWg/wLwD057HNl5+M00bz4oXepP2nYbahiRYkZC84awdpFge/hTNr KdAYt77eyWfMfXx1drO3nUGchy95F0+GtqV/ycrbskM=;
X-AuditID: c1b4fb30-f15ff700000043c4-99-5bf7f72a7805
Received: from ESESBMB503.ericsson.se (Unknown_Domain [153.88.183.116]) by sesbmg22.ericsson.net (Symantec Mail Security) with SMTP id D5.CE.17348.A27F7FB5; Fri, 23 Nov 2018 13:48:42 +0100 (CET)
Received: from ESESSMB503.ericsson.se (153.88.183.164) by ESESBMB503.ericsson.se (153.88.183.170) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1466.3; Fri, 23 Nov 2018 13:48:41 +0100
Received: from EUR03-VE1-obe.outbound.protection.outlook.com (153.88.183.157) by ESESSMB503.ericsson.se (153.88.183.164) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1466.3 via Frontend Transport; Fri, 23 Nov 2018 13:48:42 +0100
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Pb6R9fdCowA9DZFhilIs5/1Bf8qm8Et7UqTpuPeyngE=; b=UvSBwQfpY3aXf/EHhu8bwVS7/NtbvMT/U5WDtoR9tss3R+gcxvAav83bDYb4H4mrSOXS91asRcusm3Tqem5AhdvOm7vs40stM6fqMbkO5ve/VrIi/9ry80s/MEj6dgO2IgH3fKdSVCE7xvJjgGxwpj95VX6fGd5yZNpRt9gzrWQ=
Received: from VI1PR0701MB2736.eurprd07.prod.outlook.com (10.173.80.148) by VI1SPR00MB26.eurprd07.prod.outlook.com (10.172.255.151) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1361.14; Fri, 23 Nov 2018 12:48:40 +0000
Received: from VI1PR0701MB2736.eurprd07.prod.outlook.com ([fe80::70d1:cf80:392b:814b]) by VI1PR0701MB2736.eurprd07.prod.outlook.com ([fe80::70d1:cf80:392b:814b%4]) with mapi id 15.20.1382.007; Fri, 23 Nov 2018 12:48:40 +0000
From: =?utf-8?B?QmFsw6F6cyBMZW5neWVs?= <balazs.lengyel@ericsson.com>
To: Joe Clarke <jclarke@cisco.com>, "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: [netmod] Fwd: New Version Notification for draft-ietf-netmod-yang-instance-file-format-00.txt
Thread-Index: AQHUdXYipV5hG5p2iUu/shgjxloKow==
Date: Fri, 23 Nov 2018 12:48:40 +0000
Message-ID: <d871f90c-c13c-f938-b545-3afedcc6406c@ericsson.com>
References: <154147032474.4217.10743411700898817061.idtracker@ietfa.amsl.com> <07b9bcea-72e3-9986-7d42-303c4797f13a@ericsson.com> <2a796f78-41b7-376c-8f51-215d14cc4e2c@cisco.com>
In-Reply-To: <2a796f78-41b7-376c-8f51-215d14cc4e2c@cisco.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: yes
X-MS-TNEF-Correlator:
x-originating-ip: [129.192.74.5]
user-agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.3.1
x-clientproxiedby: HE1PR06CA0155.eurprd06.prod.outlook.com (2603:10a6:7:16::42) To VI1PR0701MB2736.eurprd07.prod.outlook.com (2603:10a6:801:8::20)
authentication-results: spf=none (sender IP is ) smtp.mailfrom=balazs.lengyel@ericsson.com;
x-ms-exchange-messagesentrepresentingtype: 1
x-ms-publictraffictype: Email
x-microsoft-exchange-diagnostics: 1; VI1SPR00MB26; 6:Zk9cCXY+iyyqlBWXh+XFnTzmvjrVfLqbjTS46IdMOHXK9jfSVrcbm9dZIS8nE12+BeE4GzaQCv+XxoMKFLwdhDneHVgxAhQIofD7K3ci449J2TvYCBcrhyThbrCp3kvnq7gVjrPjmjqU2oX628gj+XF/ohUeWfdIUGBIN0KcvbQa6jiykQeynQzT9hHE4qMGmymry6tJlAklBWG4oOb6izme5ErmQyh6+uUyzQziyT8PU8UYRZItnXm6V9BPR9uAEququJ5Rv/eCJcum1KYdT7bUrV62Aaz0vSZERii1NZPrzQt2ryGpJ52Bqnwnsvm9N7jWTcOeXv/l/LLOMIcLnJ6AxT+FlgzraVhP/88QTspkMlKDPFbsHaxzJeYLLjQnEMYShZ2joVidUmqqg2jQZRxdixDHkV0HRUlSHwTvhdYT2TffPQ4qmDXXguLjj6A5sz/YptjgSWMtWGfr7kcYaQ==; 5:+MiZKN0Bf5l/R2R3/DHF3qFP6DRYTH+J5TwnY08XQgFMiW25cs3E0Yts57hdOcg08jSRTg+rSZGDZv/qXD/zUaU960ZXd7fVxXfx8LlcmNaaZb3GQV2TqG/0X1hca5e3IlOg+33yoTcQAjKlW2I4pJrzqA0bTRYj0272tTB8idg=; 7:Dnzfu3YR+V4aTNtXDloaYGqcEShmFAZ2wGQC84WaHPeGAnFw8shpHa2UW1IKF+GOh87VjOAPvzu/dusdsTSH831f46P2t7b37pT0u+Br2kJAjc+TQ7p6NrgSq9gdhXR1+2p2rO7JDlX0gpRElbgFLA==
x-ms-office365-filtering-correlation-id: d44d7b97-d5a5-4754-65bf-08d65141fe5b
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390098)(7020095)(4652040)(8989299)(5600074)(711020)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(2017052603328)(7153060)(49563074)(7193020); SRVR:VI1SPR00MB26;
x-ms-traffictypediagnostic: VI1SPR00MB26:
x-microsoft-antispam-prvs: <VI1SPR00MB26136ABC21D5EC0B7D18D8F0D40@VI1SPR00MB26.eurprd07.prod.outlook.com>
x-ms-exchange-senderadcheck: 1
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(102415395)(6040522)(2401047)(5005006)(8121501046)(93006095)(93001095)(3231442)(944501410)(4983020)(52105112)(10201501046)(3002001)(148016)(149066)(150057)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(20161123560045)(20161123558120)(20161123564045)(201708071742011)(7699051)(76991095); SRVR:VI1SPR00MB26; BCL:0; PCL:0; RULEID:; SRVR:VI1SPR00MB26;
x-forefront-prvs: 086597191B
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(39860400002)(396003)(366004)(136003)(346002)(376002)(199004)(189003)(252514010)(51914003)(51444003)(316002)(52116002)(58126008)(99286004)(110136005)(6486002)(446003)(345774005)(386003)(53546011)(102836004)(6506007)(86362001)(85182001)(31696002)(3846002)(6116002)(7736002)(486006)(11346002)(66574009)(68736007)(476003)(2616005)(229853002)(76176011)(186003)(65956001)(66066001)(65806001)(71190400001)(71200400001)(26005)(6436002)(15650500001)(99936001)(14454004)(2900100001)(53936002)(8676002)(8936002)(97736004)(81156014)(81166006)(6512007)(6246003)(36756003)(25786009)(3260700006)(106356001)(966005)(85202003)(2906002)(64126003)(2501003)(105586002)(65826007)(6306002)(256004)(31686004)(236005)(54896002)(478600001)(5660300001)(606006)(14444005); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1SPR00MB26; H:VI1PR0701MB2736.eurprd07.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1;
received-spf: None (protection.outlook.com: ericsson.com does not designate permitted sender hosts)
x-microsoft-antispam-message-info: yQIrEep+IB5iwN5M2CdK0paHKzDP8Kyyy+HPWw7C5MFa+HaWs15WIOI506lnVnzTaCRIfjmj1PFK5/SKU/GvRmMXD+qMNhTmOGeAcdoBtGFwubi4nkBjPiWphovN8aw55dhDWtxFRtCP0JKw2d1pysjN6YD7JONECJk/LZ1rFX/WJ1sJKswPKEB7jnGrkfxTCPV4d9U4YvEXF144FOtFVlkuEzcBCUVjUcv/Z/+4sLGxC5uyKqFB0oqvC05AHrfe75u03IG+TBRHCAPyoaHMG8iA8EqFCPXw1tpbC4Fx0znJxevlOHMiKtIbdGiRpBP0d4OQLwaFHBMRrLzNY9gWYJ3BBVJR6PTubdq44aAFY2s=
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: multipart/signed; protocol="application/pkcs7-signature"; micalg=sha-256; boundary="------------ms030704060609020204030206"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: d44d7b97-d5a5-4754-65bf-08d65141fe5b
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Nov 2018 12:48:40.8306 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 92e84ceb-fbfd-47ab-be52-080c6b87953f
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1SPR00MB26
X-OriginatorOrg: ericsson.com
X-Brightmail-Tracker: H4sIAAAAAAAAA1WSe0iTURjGOd/37fNzNDotrTe7oCMrtcyyQLqYl1D/yYKITCtd9ZHmnLYt SQnSUssr5iV1OFy0DEwts9RITS0Fs8IKE60kL0xNM4V0eemy7Uyo/37v+zzvc857OBwt/iyw 4yLkKl4hl8okrJApCqpVbXE2GELcstRij8auBeRR8jZR4EUF5M1XCQJ0ulnqEBUs3HOGl0XE 8oqtnmHC8DuaEqsYTQa6eH8iESWgrPg0ZM0B3gEfqytQGhJyYvwCQeHIOEOKGQRVc4uKjoKp 4RnWVDA4m4bH9ZMUUfIpeK2rF5BCj6AzWc2aklm8H65NPKNMbIP9IaHhtrm/HMtA39HEkn4U pL8qtnhc4bt+0MrEDHaEgdKfyMQivA/a7nygyQE1CNpG0owmjrPGe6F9LMbkQXgFGF6Wm3No vBJ6h0oosp0N9L/tYAnbwujgbwFhe5jIbTX3bfEJKNBlmPcEfBPBp+lKhoSehPq+65bhzfC6 ewgRXgvvStItA10svNfU0UQ4ABVfBxki9CBYqLlrRQQnmNR8tlwpAlqejlpS10FZZj+TjdzU /9xcbZyncSqC1CcdtNr8BMugvWiIURu3pvEGKE2W/O83sQuU3hqjCe+GwrlmlrAD5KX3WxHe CWOtU4iwO5RW/mK1SFiGbJW88lTU2e3bXXlFxGmlMlruKudVD5HxozU/mnerQ6PD3i0Ic0iy RNQ5aQgRC6SxyrioFrTemDPw4F4nsmPk0XJeYiO64mCURWekcfG8IjpUcUHGK1vQao6RrBR5 BFYHi/FZqYqP5PkYXrGoUpy1XQKqLfDTFunTJjZo4/JffcnJavrDJLkUNbpFrll1/E2KxG+T 68YtfaDdeHC8xz9l3DH38KGojKDy0GDfZO+8gaTuTIV78+zzQXfHS96pl2OXftMPnagda8/x PB92dTKQn75x1Gmq7lyxpuZxoKr7mCzEN9fL54ePNr9hl0F1rrfA/kiVhFGGS7c50wql9C9m 8MyQcAMAAA==
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/y_DANt2ZIdjwTVL_G0zxoGE9OP8>
Subject: Re: [netmod] Fwd: New Version Notification for draft-ietf-netmod-yang-instance-file-format-00.txt
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
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: Fri, 23 Nov 2018 12:48:47 -0000

Thanks for the comments. Details below.

Balazs

On 2018. 11. 06. 4:25, Joe Clarke wrote:
On 11/5/18 21:54, Balázs Lengyel wrote:
The first WG version of the document is stored. It is the same as 
draft-lengyel-netmod-yang-instance-data-05 except for the change of title.
Thanks, Balazs.  Here is an itemized review of this draft.  Thank you
for acknowledging my requirements around augmenting YANG data/structure.
 You will definitely need that when you start to document server
capabilities.

I agree with Lada and Rob that moving the use case examples to an
appendix would make it easier to get to the meat of the document.
BALAZS: OK
In your terminology section, you define an instance data set as
essentially a set of instance data.  I might incorporate the text from
your abstract to call instance data, data that is returned from a YANG
server.  This, too, isn't ideal, but I think it's worth being a bit more
descriptive here.
You use "YANG Based Instance Data" as something that feels like a term
throughout the document, but you do not define this exactly.
BALAZS: OK.
yang _BASED_ instance data is removed as it led to confusion. I revert to the more simple "yang instance data".
Added definition for Yang Instance data
Section 2.1.1

s/Capbilites/Capabilities/

s/capabilites/capabilities/g
BALAZS: OK
You say, "While it is good practice to allow a client to query these
capabilities from the live YANG server, that is often not enough."

"Not enough" doesn't sound right.  I would say, "that is sometimes not
possible."  You may mention examples like the server is not currently
available or the code driving the server is not publicly available, etc.
BALAZS: OK, changed
You say that, "Often when a network node is released an associated NMS
is released with it."

I don't know that this coupling happens "often."  I'd say that when new
network element code is released, operators want to understand the
capabilities that come within that new code.  Other NMS/OSS vendors want
to be able to understand the model provided by the new code so they can
adjust their client code.

You go on to say, "Network operators often build their own home-grown
NMS systems that needs to be integrated with a vendor's network node."

Again, the word "often" doesn't resonate with me.  I do agree that there
are NMS vendors that need to understand how to modify their NMS to
support other vendors' network elements and there are some operators
that are building their own NMS/OSS.
BALAZS: If we think about independent NMS vendors they may release the NMS update after the new network node version is released.
My point is that, many operators will not wait for the NMS to be developed over some time. They require the NMS on day 1.
Anyway this is only an appendix now.
Section 2.1.2

s/configurationp/configuration/
BALAZS: OK
Section 2.1.3

s/Dcomenting/Documenting/
BALAZS: OK
Section 3

s/returmed/returned/

s/configuraton/configuration/
BALAZS: OK
You say, "It SHOULD NOT be used if the file is stored in a version
control system (e.g. git) because the change of file names will break
the connection between the different revisions of the file."

I think you should drop this requirement.  I can use "git mv" or create
tags if I want to retain history.  I wouldn't try and legislate what
people do with their VCS.
BALAZS: OK, although I still think it is better to avoid using the date.
You use "meta data" in a number of locations.  Might I suggest
"metadata."  I think that is a more common way to write that term.
BALAZS: OK
Section 6

With your datastore leaf, if I pull this off of a running YANG server,
serialize it and share it with my customer, why wouldn't I have the
actual datastore from which I retrieved it?  What I'm saying is that
this element may be missing, but if it is, I don't think you can assume
the source datastore for config=true nodes.
BALAZS: This should be a default value. However as the default is a simple value, but
here it really depends on the config=true/false and the existence of writable-running
I put it into the description statement. If you need something else, like in your example, go ahead specify it.
Reworded from imply to default.


s/dtastore/datastore/

s/thats/that's/

s/Formated/Formatted/
BALAZS: OK
Section 8

Do you have to register the ".yid" file extension as well?
BALAZS: Is there a registry for file extensions? I was not aware.
Thanks.

Joe

Balazs

-------- Forwarded Message --------
Subject: 	New Version Notification for
draft-ietf-netmod-yang-instance-file-format-00.txt
Date: 	Mon, 5 Nov 2018 18:12:04 -0800
From: 	internet-drafts@ietf.org
To: 	Benoit Claise <bclaise@cisco.com>, Balazs Lengyel
<balazs.lengyel@ericsson.com>




A new version of I-D, draft-ietf-netmod-yang-instance-file-format-00.txt
has been successfully submitted by Balazs Lengyel and posted to the
IETF repository.

Name: draft-ietf-netmod-yang-instance-file-format
Revision: 00
Title: YANG Instance Data File Format
Document date: 2018-11-04
Group: netmod
Pages: 14
URL:
https://www.ietf.org/internet-drafts/draft-ietf-netmod-yang-instance-file-format-00.txt" rel="nofollow">https://www.ietf.org/internet-drafts/draft-ietf-netmod-yang-instance-file-format-00.txt
Status:
https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-instance-file-format/" rel="nofollow">https://datatracker.ietf.org/doc/draft-ietf-netmod-yang-instance-file-format/
Htmlized:
https://tools.ietf.org/html/draft-ietf-netmod-yang-instance-file-format-00" rel="nofollow">https://tools.ietf.org/html/draft-ietf-netmod-yang-instance-file-format-00
Htmlized:
https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-instance-file-format" rel="nofollow">https://datatracker.ietf.org/doc/html/draft-ietf-netmod-yang-instance-file-format


Abstract:
There is a need to document data defined in YANG models without the
need to fetch it from a live YANG server. Data is often needed
already in design time or needed by groups that do not have a live
running YANG server available. This document specifies a standard
file format for YANG Based Instance data, that is data that could be
stored in a datastore and whose syntax and semantics is defined by
YANG models. Most important use cases foreseen include documenting
server capabilities, factory-default settings, or vendor provided
default configurations.



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.

The IETF Secretariat

-- 
Balazs Lengyel                       Ericsson Hungary Ltd.
Senior Specialist
Mobile: +36-70-330-7909              email: Balazs.Lengyel@ericsson.com 


_______________________________________________
netmod mailing list
netmod@ietf.org
https://www.ietf.org/mailman/listinfo/netmod" rel="nofollow">https://www.ietf.org/mailman/listinfo/netmod


-- 
Balazs Lengyel                       Ericsson Hungary Ltd.
Senior Specialist
Mobile: +36-70-330-7909              email: Balazs.Lengyel@ericsson.com