Re: [Lsr] When to augment LSR base YANG modules...

"Acee Lindem (acee)" <acee@cisco.com> Sun, 31 March 2019 21:09 UTC

Return-Path: <acee@cisco.com>
X-Original-To: lsr@ietfa.amsl.com
Delivered-To: lsr@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B004A1200D8 for <lsr@ietfa.amsl.com>; Sun, 31 Mar 2019 14:09:40 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.503
X-Spam-Level:
X-Spam-Status: No, score=-14.503 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIMWL_WL_MED=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, 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=VG9aFrn9; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=ir6mdpFB
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 Y2JNWzmjGA_C for <lsr@ietfa.amsl.com>; Sun, 31 Mar 2019 14:09:37 -0700 (PDT)
Received: from alln-iport-4.cisco.com (alln-iport-4.cisco.com [173.37.142.91]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6C574120003 for <lsr@ietf.org>; Sun, 31 Mar 2019 14:09:37 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=11804; q=dns/txt; s=iport; t=1554066577; x=1555276177; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-id:content-transfer-encoding: mime-version; bh=sQzKhKwWFBxVH2PJcnSYfrB7mv/6dygBWxHH0auQ7CM=; b=VG9aFrn9FSxmPg8joZ8dvbxOxpcseSynQB+zFTxXWdsfGk/H2g+jDWkx PBFBJp6FiclXrbD+KG60G+e7aPCbVy3tZ1pBuQaKT4vZPR49z+OM7xV2r sVpPlsi1QkHvmdUusMejoVaXxivTqTI5U4Jc4mPNrOX7h/vUtnZ9TYGjY M=;
IronPort-PHdr: 9a23:mgsEuRAjqai7zWiuuTchUyQJPHJ1sqjoPgMT9pssgq5PdaLm5Zn5IUjD/qgw3kTRU9Dd7PRJw6rNvqbsVHZIwK7JsWtKMdRXUgMdz8AfngguGsmAXETwIfPCZC0hF8MEX1hgrDm2
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0ADAABlK6Fc/51dJa1jGQEBAQEBAQEBAQEBAQcBAQEBAQGBUQQBAQEBAQsBgT0kLANodAQLJwqEBINHA4RSimCCV36WEYEugSQDVA4BARgLCYRAAheFICI0CQ0BAQMBAQkBAwJtHAyFSgEBAQMBAQEhEQwBASoCCAMBDwIBCA4DAwEBAQECAiMDAgICJQsUAQgIAgQBDQWDIgGBXQMNCAEOnVkCihRxgS+CeQEBBYFFQYJzGIIMAwWBCyQBizIXgX+BECgfghcHLj6CYQEBAwGBXSaCZDGCJop/ggSXamAJAodvi28alCyLP4YRjT0CBAIEBQIOAQEFgU04gVZwFTsqAYJBggoMF4NLg0aBToU/coEojhQBgR4BAQ
X-IronPort-AV: E=Sophos;i="5.60,294,1549929600"; d="scan'208";a="252371749"
Received: from rcdn-core-6.cisco.com ([173.37.93.157]) by alln-iport-4.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 31 Mar 2019 21:09:36 +0000
Received: from XCH-ALN-017.cisco.com (xch-aln-017.cisco.com [173.36.7.27]) by rcdn-core-6.cisco.com (8.15.2/8.15.2) with ESMTPS id x2VL9ZdY005125 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Sun, 31 Mar 2019 21:09:35 GMT
Received: from xhs-rcd-002.cisco.com (173.37.227.247) by XCH-ALN-017.cisco.com (173.36.7.27) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Sun, 31 Mar 2019 16:09:35 -0500
Received: from xhs-rcd-001.cisco.com (173.37.227.246) by xhs-rcd-002.cisco.com (173.37.227.247) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Sun, 31 Mar 2019 16:09:34 -0500
Received: from NAM05-DM3-obe.outbound.protection.outlook.com (72.163.14.9) by xhs-rcd-001.cisco.com (173.37.227.246) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Sun, 31 Mar 2019 16:09:34 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cisco.onmicrosoft.com; s=selector1-cisco-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=sQzKhKwWFBxVH2PJcnSYfrB7mv/6dygBWxHH0auQ7CM=; b=ir6mdpFBz2OfNxJg1rhiwA62f6uY+90upqFf5tx6aLlbnM6Vl296aWn+HqRtmbwF/K2seMk99AGVAfHfpiXuoEXD7tgA1P/JTr3iUnOVmdMTSIwoEKXDmnLy2jBYEnu16C+QGw0fxRTlvbsSkaJLtqSrKPHl5t6So1ujry5wqhI=
Received: from BN6PR1101MB2226.namprd11.prod.outlook.com (10.174.112.11) by BN6PR1101MB2337.namprd11.prod.outlook.com (10.173.199.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1750.20; Sun, 31 Mar 2019 21:09:32 +0000
Received: from BN6PR1101MB2226.namprd11.prod.outlook.com ([fe80::9c05:e282:840b:51a1]) by BN6PR1101MB2226.namprd11.prod.outlook.com ([fe80::9c05:e282:840b:51a1%8]) with mapi id 15.20.1750.017; Sun, 31 Mar 2019 21:09:32 +0000
From: "Acee Lindem (acee)" <acee@cisco.com>
To: Christian Hopps <chopps@chopps.org>, Yingzhen Qu <yingzhen.qu@huawei.com>
CC: Susan Hares <shares@ndzh.com>, Rob Shakir <rjs@rob.sh>, "lsr@ietf.org" <lsr@ietf.org>, Tony Li <tony.li@tony.li>
Thread-Topic: [Lsr] When to augment LSR base YANG modules...
Thread-Index: AQHU5gfd4acSIv/HVEeXIb5nGax0OaYiR5UAgAHQpQCAAGCBAIABU0mAgAA3DgCAACRggP//1YGA
Date: Sun, 31 Mar 2019 21:09:32 +0000
Message-ID: <9FACB29E-7E8C-4FDB-B45F-9002AC891113@cisco.com>
References: <sa6wokiayd9.fsf@chopps.org> <2E6CA4AD-AD65-4A20-9545-1C81ED8B8968@tony.li> <B838962D-BDEA-46C9-9B9A-587484819784@cisco.com> <CAHxMReYFQ8atP3JX9NsauB4xqtnsYCZyqjaYHH+EGi2b4Fvj=Q@mail.gmail.com> <080001d4e7cc$0b434690$21c9d3b0$@ndzh.com> <75095E67-2867-4466-B232-48E27DC47C9B@huawei.com> <E53C46A7-D0F1-4B29-97AB-2CE52E7374F8@chopps.org>
In-Reply-To: <E53C46A7-D0F1-4B29-97AB-2CE52E7374F8@chopps.org>
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=acee@cisco.com;
x-originating-ip: [173.38.117.65]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: e64df764-3ee3-4951-9523-08d6b61d2c0d
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600127)(711020)(4605104)(2017052603328)(7153060)(7193020); SRVR:BN6PR1101MB2337;
x-ms-traffictypediagnostic: BN6PR1101MB2337:
x-ms-exchange-purlcount: 2
x-microsoft-antispam-prvs: <BN6PR1101MB23370A3497A0C164D70B36A7C2540@BN6PR1101MB2337.namprd11.prod.outlook.com>
x-forefront-prvs: 0993689CD1
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(396003)(376002)(346002)(366004)(39860400002)(136003)(199004)(189003)(36756003)(26005)(6506007)(82746002)(6116002)(3846002)(66574012)(53546011)(99286004)(68736007)(2906002)(478600001)(305945005)(256004)(7736002)(14454004)(97736004)(71200400001)(83716004)(8936002)(5660300002)(81156014)(81166006)(106356001)(105586002)(8676002)(76176011)(966005)(54906003)(4326008)(110136005)(25786009)(71190400001)(33656002)(316002)(6436002)(6512007)(6306002)(6486002)(53936002)(66066001)(6246003)(476003)(2616005)(486006)(11346002)(229853002)(86362001)(93886005)(446003)(186003)(102836004); DIR:OUT; SFP:1101; SCL:1; SRVR:BN6PR1101MB2337; H:BN6PR1101MB2226.namprd11.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX: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: SlHmTxxItThmUEE76b5TKWHUa2l+aQ14+GVN0nv7RW2uUgEzZRMZoXJ5nnGyTJjMkUXlLrxIJysa4d0VhKrYxtZTL036gTaf5IFq+SaHgIuvgdaTifzXWrzkYFaiKyXg5Vnw4ZpL4npX69ze28rrTcnI1JU9g8lSeHs/CeDhvOqi5k4Q7Cyv+w0rlfhGqHBHoAi3jnF2CWElopmKsgVALpU+XuoJrdZiSGi0wsO5dQgGyaCjqaJHmTbXKjjFjVFFoZAz0rEUmpndSk2SSZdTMxIXHqY1jU04xoOaMoyjutntfJTgY7Wa8mOIKCFqMjo90ZUqIrs2T7FZixR3rLU+0jMYam8gLX39stsXKUVbD0T52mMjtxrBvO0B4xb14j4gZjxL76VHyCB8KCzlimuKmbN7kWA3mdohlY0S/1+Pc6s=
Content-Type: text/plain; charset="utf-8"
Content-ID: <96001B5558D29541BD3A283D2391D3D4@namprd11.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: e64df764-3ee3-4951-9523-08d6b61d2c0d
X-MS-Exchange-CrossTenant-originalarrivaltime: 31 Mar 2019 21:09:32.5315 (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-Transport-CrossTenantHeadersStamped: BN6PR1101MB2337
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.36.7.27, xch-aln-017.cisco.com
X-Outbound-Node: rcdn-core-6.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/lsr/K5CZnDAnineqF_mrG2_I-pqVJIQ>
Subject: Re: [Lsr] When to augment LSR base YANG modules...
X-BeenThere: lsr@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Link State Routing Working Group <lsr.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/lsr>, <mailto:lsr-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/lsr/>
List-Post: <mailto:lsr@ietf.org>
List-Help: <mailto:lsr-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/lsr>, <mailto:lsr-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 31 Mar 2019 21:09:41 -0000

Hi Chris, Yingzhen, 

Let's have a discussion on YANG doctors list on the merits of a small module per feature vs an aggregate model with features. 

We can try this as an experiment. Perhaps, we can get a permanent dispensation to the 5 author rule if every draft needs someone YANG fluent and familiar with the base OSPF and ISIS models. 

Thanks,
Acee

On 3/31/19, 3:41 PM, "Christian Hopps" <chopps@chopps.org> wrote:

    
    
    > On Mar 31, 2019, at 1:31 PM, Yingzhen Qu <yingzhen.qu@huawei.com> wrote:
    > 
    > There are many small feature drafts in LSR, for example: https://datatracker.ietf.org/doc/draft-ietf-ospf-ospfv2-hbit/  it only adds H-bit to router-lsa.
    > 
    > For sure we want models to be modular, but not too many tiny pieces. Maybe we should combine a few small features like H-Bit into one module?
    
    But why?
    
    Delaying the publication of the management definition until some (so far as I can tell) arbitrary number of features has been collected negatively impacts users. What do they gain in return?
    
    Thanks,
    Chris.
    
    > 
    > Thanks,
    > Yingzhen
    > 
    > From: Lsr <lsr-bounces@ietf.org> on behalf of Susan Hares <shares@ndzh.com>
    > Date: Sunday, March 31, 2019 at 7:15 AM
    > To: 'Rob Shakir' <rjs@rob.sh>, "'Acee Lindem (acee)'" <acee@cisco.com>
    > Cc: "lsr@ietf.org" <lsr@ietf.org>, "tony.li@tony.li" <tony.li@tony.li>, 'Christian Hopps' <chopps@chopps.org>
    > Subject: Re: [Lsr] When to augment LSR base YANG modules...
    > 
    > Rob and Acee:
    > 
    > I agree that with Rob that it is a generic problem that you must have a robust way to version and revise the Yang models.   This is true for configuration, operational data, and dynamic data stores.   The netmod modeling is focusing on configuration at this time.
    > 
    > It is critical to determine how the base models yang models prepare for augmentations.  OSPF, ISIS, BGP, FIB/RIB, and policy are key models.   Since our protocols are augmented based on capabilities, augmentation based on the same capabilities for models makes the most sense.   We can review info/data, and code functionality based on the key senses.
    > 
    > If we have good versioning of the base model, can revise both the data model and the capability independently.   If we utilize the grouping of data models based on the versioning, automatic deployment of this work can occur.
    > 
    > Acee and Chris has been actively participating on the versioning discussion in netmod’s work on versioning.   I’m sure they can report if they feel the support his there for this type of version.
    > 
    > BGP and rtgwg can integrate this type of version prior to the upcoming WG LC.
    > 
    > Sue
    > 
    > 
    > From: Lsr [mailto:lsr-bounces@ietf.org] On Behalf Of Rob Shakir
    > Sent: Saturday, March 30, 2019 2:00 PM
    > To: Acee Lindem (acee)
    > Cc: lsr@ietf.org; tony.li@tony.li; Christian Hopps
    > Subject: Re: [Lsr] When to augment LSR base YANG modules...
    > 
    > I think this is a generic challenge that has to be solved across all protocols -- and relies on a robust way to version and revise YANG modules in the IETF.
    > 
    > In OpenConfig, as we're very lightweight for pushing a new revision, since we're just specifying new versions of modules, adding new features to an existing module is pretty trivial. They can be done as a minor revision if there's no backwards incompatible changes.  It seems better, to me, to ensure that there is common logic for how one splits up modules, to make things actually usable for developers trying to consume them, rather than needing to understand when and where in the IETF a feature was developed.
    > 
    > That being said -- this means one should probably expect each LSR base module to be revised with most new LSR RFCs. With the current agility of the review and publication process -- I'm not sure that is realistic either.
    > 
    > r.
    > 
    > On Sat, 30 Mar 2019 at 09:15, Acee Lindem (acee) <acee@cisco.com> wrote:
    > Speaking as WG member:
    > 
    > For many of the new LSR WG documents, we are already included both OSPF and IS-IS encodings in a single document. Now, we have agreed that documents requiring simple BGP-LS changes will also include the BGP-LS encoding. Given this, I don't want to add another requirement for publication of a WG document. This would also add additional reviews to the document. You've all heard the expression "divide and conquer", while let me introduce the corollary, "consolidate and stagnate".
    > 
    > Additionally, I agree with Yingzhen's comment that it is not clear that we want a separate YANG module for every OSPF/IS-IS feature.
    > 
    > Thanks,
    > Acee
    > 
    > On 3/29/19, 4:33 AM, "Lsr on behalf of tony.li@tony.li" <lsr-bounces@ietf.org on behalf of tony.li@tony.li> wrote:
    > 
    > 
    >     Chris,
    > 
    >     One concern is simply one of scale: doing this will increase the size of the document.  At what point do things become sufficiently awkward that we want to have a separate, concurrent document.
    > 
    >     In other words, if the requirement is for concurrent delivery, is co-location really a requirement?
    > 
    >     Regards,
    >     Tony
    > 
    > 
    >     > On Mar 29, 2019, at 9:17 AM, Christian Hopps <chopps@chopps.org> wrote:
    >     >
    >     >
    >     > The base YANG modules for IS-IS and OSPF both include operational state to describe TLV data. During the discussion about OSPFv3's version of this data, I brought up the issue of when and how the base modules should be augmented to add new TLV types to the model, suggesting it be done inline and with the RFC that adds the new feature/functionality to the protocol.
    >     >
    >     > I'll go farther here and say this should apply to all the YANG required for management of the new feature, and it should all be added inline with the feature (i.e., in the same draft). In other words new features/functionality should include the YANG augment required to manage said features/functionality.
    >     >
    >     > This has been suggested/tried previously with SNMP with varying (low) levels of success. The difference here is 1) YANG additions (a new module perhaps just augmenting the base) is easy, whereas SNMP wasn't. Additionally, operators weren't using SNMP to fully manage functionality (e.g., not doing configuration) so a requirement for extra work was harder to justify. Operators *do* want to fully manage their networks/servers with YANG though.
    >     >
    >     > The argument against this during the meeting was that it would create many small modules. I don't find this compelling (i.e., "so"? :)
    >     >
    >     > Assume I'm an operator -- the actual consumer of this management stuff:
    >     >
    >     > - If I'm going to use this new feature X, I need to be able to manage it. So I need it YANG for it. Not only do I need any new TLV data in the operational state, but I need the configuration and any other operational state right along with it. Otherwise each vendor has to add new YANG to their vendor modules, or the feature is useless to me. I can't use something if I can't turn it on.
    >     >
    >     > - I don't care about having many smaller modules that augment the base module -- at all. Quite the opposite actually, when new functionality is accompanied by it's own module it provides me a simple way to see if that functionality is present as the module will be present in the YANG capabilities announced by the device.
    >     >
    >     > I'd be interested in hearing reasons we (as a WG) shouldn't just expect a YANG module (even if it's small) to be included with drafts that add new functionality.
    >     >
    >     > Thanks,
    >     > Chris.
    >     > _______________________________________________
    >     > Lsr mailing list
    >     > Lsr@ietf.org
    >     > https://www.ietf.org/mailman/listinfo/lsr
    > 
    >     _______________________________________________
    >     Lsr mailing list
    >     Lsr@ietf.org
    >     https://www.ietf.org/mailman/listinfo/lsr
    > 
    > 
    > _______________________________________________
    > Lsr mailing list
    > Lsr@ietf.org
    > https://www.ietf.org/mailman/listinfo/lsr
    > _______________________________________________
    > Lsr mailing list
    > Lsr@ietf.org
    > https://www.ietf.org/mailman/listinfo/lsr