[Netmod-ver-dt] Solution overview draft, delete duplicate requirements
"Rob Wilton (rwilton)" <rwilton@cisco.com> Thu, 12 September 2019 11:06 UTC
Return-Path: <rwilton@cisco.com>
X-Original-To: netmod-ver-dt@ietfa.amsl.com
Delivered-To: netmod-ver-dt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 73CAC12083F for <netmod-ver-dt@ietfa.amsl.com>; Thu, 12 Sep 2019 04:06:23 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.5
X-Spam-Level:
X-Spam-Status: No, score=-14.5 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com header.b=AX6TNGc8; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=dGhtAPJe
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 c0oPeBltm5vc for <netmod-ver-dt@ietfa.amsl.com>; Thu, 12 Sep 2019 04:06:21 -0700 (PDT)
Received: from alln-iport-1.cisco.com (alln-iport-1.cisco.com [173.37.142.88]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 1CAF6120833 for <netmod-ver-dt@ietf.org>; Thu, 12 Sep 2019 04:06:18 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=18013; q=dns/txt; s=iport; t=1568286378; x=1569495978; h=from:to:subject:date:message-id:mime-version; bh=utSycFg8Os07WDIbsuNwGiwzPQRDQX7QZY4uobaiNpM=; b=AX6TNGc84NT6rHPwpItSpCceA24BYY+CMSGiCJU25PXucUabFjXhY3U2 M+FLFjSs/KHt9wF0XwIc1bGITtjAgUmyMcQ/3jL3H1tMLyKHa3+NO9cjA O+f2VuHhdxA229aVBYRqzer6EKxyzxzd6t7UXeVIIRN9CfeHfw1VH9Z9T g=;
IronPort-PHdr: 9a23:UtV/7x+EA5dUyv9uRHGN82YQeigqvan1NQcJ650hzqhDabmn44+8ZB7E/fs4iljPUM2b8P9Ch+fM+4HYEW0bqdfk0jgZdYBUERoMiMEYhQslVdSaCEnnK/jCZC0hF8MEX1hgrDm2
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0AIAQBgJXpd/4MNJK1mHQEBBQEHBQGBVQYBCwGBFS9QA21WIAQLKgqHXgOKak2Zf4EugSQDVAkBAQEMAQEjCgIBAYQ/AoJbIzYHDgIDCQEBBAEBAQIBBgRthS4BC4VjGxMBATgRAYEAJgEEGxMHgwGBHU0DHQECDKANAoE4iGGCJYJ9AQEFhQkYghYDBoE0AYt3GIFAP4ERRoIeg00CgWODO4ImjFw0h1GJGI5SCoIhA4Z+jhGZCo1/iASQagIEAgQFAg4BAQWBWQcqgVhwFTuCbIJCg3KKU3OBKY1cAYEiAQE
X-IronPort-AV: E=Sophos;i="5.64,495,1559520000"; d="scan'208,217";a="324759818"
Received: from alln-core-1.cisco.com ([173.36.13.131]) by alln-iport-1.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 12 Sep 2019 11:06:17 +0000
Received: from XCH-RCD-001.cisco.com (xch-rcd-001.cisco.com [173.37.102.11]) by alln-core-1.cisco.com (8.15.2/8.15.2) with ESMTPS id x8CB6G43016181 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL) for <netmod-ver-dt@ietf.org>; Thu, 12 Sep 2019 11:06:17 GMT
Received: from xhs-rcd-003.cisco.com (173.37.227.248) by XCH-RCD-001.cisco.com (173.37.102.11) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Thu, 12 Sep 2019 06:06:16 -0500
Received: from xhs-aln-003.cisco.com (173.37.135.120) by xhs-rcd-003.cisco.com (173.37.227.248) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Thu, 12 Sep 2019 06:06:16 -0500
Received: from NAM04-CO1-obe.outbound.protection.outlook.com (173.37.151.57) by xhs-aln-003.cisco.com (173.37.135.120) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Thu, 12 Sep 2019 06:06:16 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=n0QlD4i2tV6NmpmXO/JCoGj0aaIsgs4AqD8AGyvMZZpztTuE7kXx80OZj+v9VWo0fH7gCHmpqIxDmS8gFpR8sjZJhb7sEXm8WSCexfNBGtt+CYXrtjiFItcvejR8YzrFgLVej/Dip/De97Xj1oG1GefD97ksNN7hnXl2k2yBYoIb9vGehIbDK2JzThgfrILhUFTs8XXPsTldV0s88Mx+29pJYWQejXpqIxQpkzMwAPLC7s8PiECt81CxsRCKZZRTV+URPZbcfJ/JzLLZp1fl9BJsBYqxQ6P+Q4JACjmHPIK91ROU5Y5wqxZoNVeOurxf+e7LMDdcdFC/UdlYIcT61g==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=l9NftLzd/MbToEP2Mvq37OmR7BOX8t9BA+mkz6qPkNg=; b=BPT6mDXDzYetede0LJK5w43d44FYVLMhjSCWNzLHD49GNbgDAVQdyV8S3lrT8vXI0pBusQiWUfxQwyyQjk0aUgWjKLHiInyZ51DlvgvpmTuMYjkG/skuIPrjU+rqngrObc4w7FAfKA+5DTH04Y6YIetV9rBCVFAljdIQxVbHPxXy0vCnYqV2a8M0Vh9AiKOEjF7IUu57IC4th00cDd4AbDc9RuJkIU9esDU5bMa052Q8WTH9n9XRldVoy6I9OaMLEtGh13GV42hQaY1B1kLW5zCoB+xfvKrTvwabdRw63r3sQ0USS90c4NXco/vyrut0EFovrulH3hn25EyTXNwCVA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=cisco.com; dmarc=pass action=none header.from=cisco.com; dkim=pass header.d=cisco.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cisco.onmicrosoft.com; s=selector2-cisco-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=l9NftLzd/MbToEP2Mvq37OmR7BOX8t9BA+mkz6qPkNg=; b=dGhtAPJewdgTh+06/5+vJ5HUSrw8l0ZM5nkGkYC552c4OUdb4hlQDtwmfAaLKDKt9jkzw+EeHGEuabxLm7qlEqmbJ91mCAWnUbYAhqJrUExq3AhB9krhAxr48R2pTLL0ZaoHW6WWADEvsGahM8TfphX/Ae+RTpwEQnvXJbELH5E=
Received: from MN2PR11MB4366.namprd11.prod.outlook.com (52.135.38.209) by MN2PR11MB3805.namprd11.prod.outlook.com (20.178.254.24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2241.18; Thu, 12 Sep 2019 11:06:14 +0000
Received: from MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::6db3:f4c:467b:30f6]) by MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::6db3:f4c:467b:30f6%7]) with mapi id 15.20.2241.022; Thu, 12 Sep 2019 11:06:14 +0000
From: "Rob Wilton (rwilton)" <rwilton@cisco.com>
To: "netmod-ver-dt@ietf.org" <netmod-ver-dt@ietf.org>
Thread-Topic: Solution overview draft, delete duplicate requirements
Thread-Index: AdVpWhVkJ54G/fLiTbKZReFEmPXTUw==
Date: Thu, 12 Sep 2019 11:06:14 +0000
Message-ID: <MN2PR11MB4366EF1C65517735C3439B52B5B00@MN2PR11MB4366.namprd11.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=rwilton@cisco.com;
x-originating-ip: [173.38.220.38]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 174b5243-25f1-4982-c1ec-08d737713a36
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600166)(711020)(4605104)(1401327)(2017052603328)(7193020); SRVR:MN2PR11MB3805;
x-ms-traffictypediagnostic: MN2PR11MB3805:
x-ms-exchange-purlcount: 3
x-microsoft-antispam-prvs: <MN2PR11MB38050391BA76A8840F14A022B5B00@MN2PR11MB3805.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 01583E185C
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(346002)(376002)(136003)(366004)(396003)(39860400002)(189003)(199004)(52536014)(7696005)(5660300002)(478600001)(33656002)(66574012)(6506007)(14454004)(74316002)(476003)(76116006)(3846002)(2501003)(53936002)(6116002)(790700001)(256004)(25786009)(486006)(14444005)(86362001)(54896002)(2351001)(71190400001)(9686003)(2906002)(102836004)(55016002)(8676002)(81156014)(81166006)(26005)(7736002)(71200400001)(316002)(66446008)(99286004)(6436002)(66066001)(5640700003)(8936002)(186003)(64756008)(66946007)(66476007)(66556008)(6306002)(6916009); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR11MB3805; H:MN2PR11MB4366.namprd11.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1;
received-spf: None (protection.outlook.com: cisco.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam-message-info: HYxhdzLWNVth+t6Hs4QOs7mKf6D/hb6wKS8PpIOY5lrWYK2LKHSyBj7j4L2GybLKl3/6s1mQFNIt9cExfwox6DdgxF3fcJLH3Z0cvWglhkKZ9H6yXvmpYwaCFdZR21+GagmqWWZli79bztCYnKPSy9yOnxxQh0mZQgnvdnVBTva825Q/t3WdKi72sD+G1mU9+eRI5TgSee7NRNwWSAxFF0cVdUMGSGd/nY5jt9u83bcmGDujxjKf6IaY/6gtPryzgHEXUcaNELtc1Lv/k2YK+LVptEwspzAh0kV88r0Q6AWoRINW1OZt7XN9tyrPOmjF4uPje6/0w+EdI2Ko47+JOvEde2D4w+nYTnV6u8GwcICMYEn0APlGt75LUHr8Yl/+QzhmqAmKhSPzGpoCdX08XdDrqqHlDBIVABASvloHVeA=
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_MN2PR11MB4366EF1C65517735C3439B52B5B00MN2PR11MB4366namp_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 174b5243-25f1-4982-c1ec-08d737713a36
X-MS-Exchange-CrossTenant-originalarrivaltime: 12 Sep 2019 11:06:14.1295 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 5ae1af62-9505-4097-a69a-c1553ef7840e
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: RtL6kdoG0zMxjM0K/+bLSrBr8DhkEd0c781q8V7/bkrEee3tgQbDyGAhJN6CxcbSA4lC1w4qZY434RDZMyr/Tg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB3805
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.11, xch-rcd-001.cisco.com
X-Outbound-Node: alln-core-1.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod-ver-dt/21QaBxU4VZs_kPpp_RVQ_TYTJrE>
Subject: [Netmod-ver-dt] Solution overview draft, delete duplicate requirements
X-BeenThere: netmod-ver-dt@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NetMod WG YANG Model Versioning Design Team <netmod-ver-dt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod-ver-dt>, <mailto:netmod-ver-dt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod-ver-dt/>
List-Post: <mailto:netmod-ver-dt@ietf.org>
List-Help: <mailto:netmod-ver-dt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod-ver-dt>, <mailto:netmod-ver-dt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 12 Sep 2019 11:06:23 -0000
One item of feedback received from the mic was to not list the requirements in two places. Currently, the solution overview draft has the following text. I'm proposing that I just remove the section 2 (which is a rewording of the requirements), since the introduction already references the requirements. Any objections? Thanks, Rob 1. Introduction TODO - Fixup references to individual drafts. [I-D.ietf-netmod-yang-versioning-reqs] documents the requirements for any solution to the YANG versioning problem. Chapter 5 lists the formal requirements that a complete solution requires. The aim of this draft is to help readers understand how the different solution drafts fit together, and also which drafts contribute solutions to particular individual requirements. The overall solution comprises five individual drafts: 1. Module revision extensions 2. Module semantic version number scheme 3. [I-D.rwilton-netmod-yang-packages] 4. [I-D.wilton-netmod-yang-ver-selection] 5. YANG schema comparison tooling (not yet published) Open issues, across all of the solution drafts are tracked at <https://github.com/netmod-wg/yang-ver-dt/issues>. Wilton Expires December 2, 2019 [Page 2] Internet-Draft YANG Versioning Solution Overview May 2019 2. Summary of requirements The requirements are formally documented in section 5 of [I-D.ietf-netmod-yang-versioning-reqs]. A shortened, non normative, summary of each of the requirements (using the same requirement numbers) is provided below to help understand how the solutions drafts address the particular requirements. Req 1.1 - MUST allow nbc updates to a module without breaking imports. Req 1.2 - MUST allow nbc updates to a module without affecting existing client code using only unchanged data nodes. Req 1.3 - MUST support import statement restricted to only some revisions. Req 1.4 - MUST allow for fixes to non-latest published modules. Req 2.1 - MUST be able to determine if two arbitrary versions of any module are backwards-compatible. Req 2.2 - SHOULD be able to determine if two arbitrary versions of any data node are backwards-compatible. Req 3.1 - MUST allow servers to support existing clients. Req 3.2 - MUST allow simultaneously support of clients using different (perhaps restricted) revisions. Req 3.3 - MAY assume clients can handle unexpected instance data gracefully. Req 4.1 - MUST provide a way to indicate if deprecated nodes are implemented. Req 4.2 - MUST be able to document the reason for data node lifecycle changes, and possible alternative data nodes. Req 4.3 - MUST be able to forewarn of future data node lifecycle changes. Req 5.1 - MUST provide guidance on how to use the new scheme. Req 5.2 - MUST provide, and document, an upgrade path from existing YANG/protocols. Req 5.3 - MUST consider the impact of versioning on instance data.
- [Netmod-ver-dt] Solution overview draft, delete d… Rob Wilton (rwilton)
- Re: [Netmod-ver-dt] Solution overview draft, dele… Joe Clarke (jclarke)