[netmod] How to specify the target modules for YANG instance data [was: Re: validity of instance-data]

Balázs Lengyel <balazs.lengyel@ericsson.com> Fri, 23 November 2018 14:33 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 7F226130E09 for <netmod@ietfa.amsl.com>; Fri, 23 Nov 2018 06:33:43 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.782
X-Spam-Level:
X-Spam-Status: No, score=-4.782 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, 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=I+TqgmjB; dkim=pass (1024-bit key) header.d=ericsson.com header.b=cH654cxw
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 dXx2V8NYrl6H for <netmod@ietfa.amsl.com>; Fri, 23 Nov 2018 06:33:41 -0800 (PST)
Received: from sessmg23.ericsson.net (sessmg23.ericsson.net [193.180.251.45]) (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 B0D50130DFF for <netmod@ietf.org>; Fri, 23 Nov 2018 06:33:40 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; d=ericsson.com; s=mailgw201801; c=relaxed/simple; q=dns/txt; i=@ericsson.com; t=1542983618; x=1545575618; 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=5IR4QWaf/ICv2xAC8p8KcpAIt74Qx1ulemMoHgAIl+0=; b=I+TqgmjBTrCKvucEsBlACQoFi2nj8mYcfl7ZFp/cqmjCk7nH0k4OqUmA1cWfDMpB kI0JZLCzSRvgApRcn9O/tRg23OxsJspN+H0kOayscOEF+JYuqPgkGKGrUTpV8Fpz VeIaXg080NrfwcXn+iCfCvKRZYWInQI+GWLwTx69wIc=;
X-AuditID: c1b4fb2d-f49ff70000007af1-0e-5bf80fc2c9a7
Received: from ESESSMB501.ericsson.se (Unknown_Domain [153.88.183.119]) by sessmg23.ericsson.net (Symantec Mail Security) with SMTP id 1D.82.31473.2CF08FB5; Fri, 23 Nov 2018 15:33:38 +0100 (CET)
Received: from ESESSMB503.ericsson.se (153.88.183.164) by ESESSMB501.ericsson.se (153.88.183.162) 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 15:33:37 +0100
Received: from EUR03-AM5-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 15:33:37 +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=VBB1sMipe5hP8woJSq4Iplrox9RcULoLnfHOOcu1ZTc=; b=cH654cxwTnYJNfC2HVMijyv/zgynPP+q6SG0Ldxbgx4Bw4uBYTKFoX7SZB7UZQCowNfTEREP8lqcbstaPnyz03Vel/773vl2TMoTeqE4K5ovzwjpav/bOGvkL+b+zBtWfl0LizMSRdFCK3krxc29CgYNC5wkPd9+yXOh0DqQq5A=
Received: from VI1PR0701MB2736.eurprd07.prod.outlook.com (10.173.80.148) by VI1PR0701MB2173.eurprd07.prod.outlook.com (10.169.137.18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1361.12; Fri, 23 Nov 2018 14:33:36 +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 14:33:36 +0000
From: =?utf-8?B?QmFsw6F6cyBMZW5neWVs?= <balazs.lengyel@ericsson.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: How to specify the target modules for YANG instance data [was: Re: [netmod] validity of instance-data]
Thread-Index: AQHUgzmEPXqfl/f2XUmUBRzHbM8DUw==
Date: Fri, 23 Nov 2018 14:33:36 +0000
Message-ID: <e48b4434-da82-9004-ba3e-963490f82fcd@ericsson.com>
References: <87sh0eil1b.fsf@nic.cz>
In-Reply-To: <87sh0eil1b.fsf@nic.cz>
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: HE1PR09CA0071.eurprd09.prod.outlook.com (2603:10a6:7:3d::15) 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; VI1PR0701MB2173; 6:t33gI5yS7hZK77KFs7nDkDh3o4CZFo7MDYNcCPepUswTsxuSGEfSr53Pvb1Pct1XZZtvMlqPqbxzlbcf4gAoyENaTd7bQhYMjtI3zIXOMcqOjoTIwZ/+6i7T6W5sUuIXVi9+YTMiCibfXGS890182nyuOD86KXraEZo2p5xbh+nTR3K7FRV+b6MM+Dkskl2sKsyE2kazeyHAnXaY0QkVX5h8mx5AoTXXbQjc55XbZ+T9axIPm92JqzZ8uP4besRh1QZlltPSabuBVfkS8emGg3pUa3j3SN96XXrtO/3ILDdcKckfBxSWweQFoludRFQ96Ex8fMA3fc3bvD5no0wUfiotVar0CsOwlA+fv8fgJ/XmFfRkiEOHQKz0bGpkOV9SjaxyMc7HyVlfRzA7GEVZhemjD0jlJUC/H5V6Qy38ADBNqB1Kh74T3OJSwhiCmFmtwkuNqxgMhnptleorNbLeiw==; 5:MzdQ38Jha92NjAyogI3DDGjudQuYa8mBRbjI1/hnDBUnhm6g47C+cfGWn0O9Zxga1NIhzKBLBToKoU3DckgUiz/vu7zZ5NDKHthv7EPvKI8wpXEpUpvw8cNXzFHQI4Tvmy/Alr0wEkethKEyFF3kIee8318guP+0IZZwIsMJZW0=; 7:HDTJleHDk4vdI8vVkLvt7dDTSW7zhUD8W/DR3ln8wr076VEHyIVoVMM2tBKcakMNv5+3JF/x2USPapSQHz5RmS/PuDdwYlffvc+BjmZ3fYq2gkaHA7FqIA2G2pDSapLNptCSQ/7n8dbFsb+ej43qWw==
x-ms-office365-filtering-correlation-id: 93205e75-4205-4dea-2ffd-08d65150a695
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390098)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600074)(711020)(2017052603328)(7153060)(49563074)(7193020); SRVR:VI1PR0701MB2173;
x-ms-traffictypediagnostic: VI1PR0701MB2173:
x-microsoft-antispam-prvs: <VI1PR0701MB2173EEEFF76571727DC13FC8F0D40@VI1PR0701MB2173.eurprd07.prod.outlook.com>
x-ms-exchange-senderadcheck: 1
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(102415395)(6040522)(2401047)(8121501046)(5005006)(3002001)(3231442)(944501410)(4983020)(52105112)(93006095)(93001095)(10201501046)(148016)(149066)(150057)(6041310)(20161123564045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(20161123562045)(20161123560045)(201708071742011)(7699051)(76991095); SRVR:VI1PR0701MB2173; BCL:0; PCL:0; RULEID:; SRVR:VI1PR0701MB2173;
x-forefront-prvs: 086597191B
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(346002)(136003)(396003)(376002)(39860400002)(366004)(199004)(189003)(252514010)(31686004)(64126003)(8676002)(106356001)(65806001)(256004)(476003)(478600001)(3846002)(6116002)(85202003)(2501003)(105586002)(2616005)(65826007)(66066001)(5660300001)(26005)(102836004)(316002)(386003)(65956001)(7736002)(97736004)(186003)(6506007)(3260700006)(76176011)(2900100001)(1730700003)(8936002)(81156014)(81166006)(85182001)(52116002)(6512007)(58126008)(486006)(71190400001)(71200400001)(6436002)(99286004)(86362001)(11346002)(68736007)(36756003)(2906002)(446003)(6486002)(5640700003)(53936002)(25786009)(99936001)(305945005)(6916009)(2351001)(14454004)(31696002); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR0701MB2173; 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: bttuTo98KvOdQxj6TTr/+ewEMM8mFAbC5yhNKsg6AZ56xEPUxVDVyVS7Fmzv+kBhKdtpB7XXuMvxOGtTgeQnAK2VnWGWHhreoCHg8Xtvg+nHrhFXNqdG8L2XsANU2DRrMaYOwkpyJ7WQYyCHXSLzd3kGpLhwo/fFQu1K01eEPwyh65ZUKLlXJGs99I2DiGPXe887YFUKqL7DHhnyut01ZcMtY8N6r5685iATv2tME7aWDwrs9Fy9COPIs1hH2E8uvLJholO6sTEhPLli+NPSgBtEd6xT3eYsvJ0upgebNUh5Ryw0MjNpBpfun1timZF2r1nkxZlirIMolA8iOH9YJ3J+9jQxlgDGdDc6Ne2zYFo=
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: multipart/signed; protocol="application/pkcs7-signature"; micalg=sha-256; boundary="------------ms040302090903030208050208"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 93205e75-4205-4dea-2ffd-08d65150a695
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Nov 2018 14:33:36.5772 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 92e84ceb-fbfd-47ab-be52-080c6b87953f
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0701MB2173
X-OriginatorOrg: ericsson.com
X-Brightmail-Tracker: H4sIAAAAAAAAA1WSaUhUURTHuW/ePJ+jg7fR0ZNR6GgomZNrCdkGFlYIfkuUrFGfS+lo88zU CDWIXDLUzO2DS40WGrlbwpQoaWWlToFlruOGJSoh7mQ5cxXq2++c8///OedyWYFEK7Rmo5Tx nEqpiJYxIro44MUN5w6z1SCXwkpHrzJtmvAk8lWr1yh/FCjyDuOioxI41aHjl0WRr3P7jeJy /BPn8teZVKT1zUTGLGAPGJtbMMpEIlaC3yBYXMijSbGMoGlNi0ihpqD/XSWjL2icI4DypkWK TAopSG8hEwmeRjAxtkHpkxnsA3fn2wxsgR2guLWW0bM5vgYjmxlC0k+AgZ/d2xo5lDcWGDQ0 3g9Fvdm0nsX4BHQ9bTHoJdgO1mZatzQsa4zt4VFPoL6NsCWsdD8zxAiwFXyfLKPIcRag035g CEvhx8SmkLANzD/oNPSl+CIUqu8ZzgRcgGDqYxEiocGgGUnfNh+ET18nEeG98Lksa5u/MfBn 2oywH+Q2NtMkaAiBrrSX2jFr0uqNCMeC5sn9bd4H1dk6Oge5lPyzeMmWX4AzEMyNvGVKDA+w C94XT9JEdBhKG3UCwk5QVTEr+N+s56NQtN7OELaF/CydEWFPmO38hQi7Q9Xz30w5ElUjKc/x fEyEm7ucU0WF8nysUq7k4hvQ1udqb9pwfolqZk91IMwimal4ULQaJBEqEvikmA5kv5UzXlfT h6xpZaySk1mIb9uuBEnEYYqkZE4Ve0l1PZrjO9AelpZZieXVmkAJjlDEc1c5Lo5T7Uwp1tg6 FTl5mtj4Wr5auuNxzK8O7NxmHVKn0jQF53Y31hxpqw2xT6yJjIuvH0/sFkqHh8difLJdp73P ng1PSZG3PLyiDsZDDRMBkReWw0POfFGf15o3r+fZdPU1SZuVa4WmMzdvKUbTH9sOJsf0FVWM KidDAx0HvHqWvNNPm1RmTHgHU+1dMpqPVLgeEKh4xV+x+brIZAMAAA==
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/K1EkSOZ6CSuA3q1kG0LaHDpNuBc>
Subject: [netmod] How to specify the target modules for YANG instance data [was: Re: validity of instance-data]
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 14:33:44 -0000

Hello Lada,

I like your idea idea, thanks. Adding some more details :

     Metadata MUST include:

    o  Name of the instance data set

    o  target: Specifies the method and details by which the target YANG
       modules, supported features and deviations are specified.  The
       specified target only indicates the set of modules that were used
       to define this YANG instance data set.  Whether the instance data
       set is usable for a different real-life target YANG module set
       depends on the compatibility between the specified target and the
       real-life target YANG module set (considering revisios, features,
       devaiations)

    Metadata SHOULD include:

    o  Revision date of the instance data set

    o  Description of the instance data set.  The description SHOULD
       contain information whether and how the data can change during the
       lifetime of the YANG server.

    Target SHALL use one of the following methods:

    IN-LINE Method.  Target should bet set to:

       'inline:ietf-yang-library@' revision-date '.yang'

       E.g. inline:ietf-yang-library@2016-06-21.yang

    The revision date is mandatory, it specifies the revision of the
    ietf-yang-library used by the in-line method.  When using the in-line
    method the first group of data inside the "anydata data" element MUST
    be the instance data targeted at the ietf-yang-library.  This data
    SHALL specify the target YANG modules, revisions, supported features
    and deviations for this and all the other target YANG modules.

    URI Method.  Target MUST bet set to a URI that references another
    YANG instance data file.  The first instance data file will use the
    same set of target YANG modules, revisions, supported features and
    deviations as this other referenced YANG instance data file.  The
    referenced YANG instance data file might use the in-line method or
    might use the URI method to reference further instance data file(s).
    However at the end of this reference chain there MUST be an instance
    data file using the in-line method.  This last instance data file
    MUST carry instance data for the ietf-yang-library, but often will
    carry no other instance data.  If a referenced instance data file is
    not available the revision data, supported features and devaitions
    for the target YANG modules are unknown.

    TODO: extend example with target.

regards Balazs

On 2018. 11. 06. 10:59, Ladislav Lhotka wrote:
> Hi,
>
> the second bullet of Appendix A in
> draft-ietf-netmod-yang-instance-file-format-00 talks about
> validity. This would make sense if we have a complete schema - YANG
> modules, even with revisions, is not enough. The schema can be provided
> off-line but it can also be specified as a part of the metadata.
>
> I would suggest to extend the metadata with the following two optional
> methods of specifying the schema:
>
> 1. the schema can be specified in-line, for example in the format of the
>     new YANG library, i.e. as a list of module-sets
>
> 2. A URL specifying the location of the schema.
>
> Lada
>
-- 
Balazs Lengyel                       Ericsson Hungary Ltd.
Senior Specialist
Mobile: +36-70-330-7909              email: Balazs.Lengyel@ericsson.com