Re: [yang-doctors] [I2nsf] Yangdoctors last call review of draft-ietf-i2nsf-registration-interface-dm-04

"Reshad Rahman (rrahman)" <rrahman@cisco.com> Mon, 11 November 2019 16:58 UTC

Return-Path: <rrahman@cisco.com>
X-Original-To: yang-doctors@ietfa.amsl.com
Delivered-To: yang-doctors@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 227AA120A21; Mon, 11 Nov 2019 08:58:16 -0800 (PST)
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=TGI286pL; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=ioxKguTO
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 5xfu8GhRZPrD; Mon, 11 Nov 2019 08:58:13 -0800 (PST)
Received: from rcdn-iport-6.cisco.com (rcdn-iport-6.cisco.com [173.37.86.77]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 49688120A1C; Mon, 11 Nov 2019 08:58:13 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=35047; q=dns/txt; s=iport; t=1573491493; x=1574701093; h=from:to:cc:subject:date:message-id:references: in-reply-to:mime-version; bh=xVShzeTVUmQ2MHzHWOcO3iaEo57GH26FiTT7zHTWP9w=; b=TGI286pLqnQ+AjGGDgehhHFluqi1a/UBkJrPNt0/BDOtV2eudQY4JV8N vdOV+XiEJKHPUkZOA3SGZDBth+gLljYYpFXJx9XJbdoAKeaZmP2LL9yrR UQsqQUA73FIR1L9Oo0oMJti8T69uC9jK8wLELC+7agl2VKUj+f3AYwU0e Q=;
IronPort-PHdr: 9a23:gVQg6xYMGamXsGTlihs2A3z/LSx94ef9IxIV55w7irlHbqWk+dH4MVfC4el20gebRp3VvvRDjeee87vtX2AN+96giDgDa9QNMn1NksAKh0olCc+BB1f8KavwdSU6Gc1EfFRk5Hq8d0NSHZW2ag==
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0BAAACLksld/5FdJa1KGhoBAQEBAQEBAQEDAQEBAREBAQECAgEBAQGBbAMBAQEBCwGBGy9QBWxYIAQLKoQpg0YDimpOgWsliViOKIEuFIEQA1QJAQEBDAEBGAEOBgIBAYFMgT6BNgIXg30kNgcOAgMLAQEEAQEBAgEFBG2FNwyFUQEBAQEDAQEQEQQZAQEpAwsBDQICAQgRAwECIQcDAgICFAsGCxQJCAIEDgUigwABgXlNAy4BDjmhUQKBOIhgdX8zgn4BAQWBNAEDAgELAkABgwINC4IXCQWBMQGMExiBQD+BOAwTgh4uPoIbRwEBAQIBgSIIAQsBBgE2CQ0JgloyggoijROCQjeFQySGVIJFjkdBCoIlhxeFJIR3BIQOG4I9coZvj1uQCIUggVWCEo8uAgQCBAUCDgEBBYE/GgExZ3FwFTsqAYJBCUcRFJASJDiDO2qEKoU/dAGBJ4sMAQENFweCEwEB
X-IronPort-AV: E=Sophos;i="5.68,293,1569283200"; d="scan'208,217";a="663821191"
Received: from rcdn-core-9.cisco.com ([173.37.93.145]) by rcdn-iport-6.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 11 Nov 2019 16:58:11 +0000
Received: from xch-rcd-011.cisco.com (xch-rcd-011.cisco.com [173.37.102.21]) by rcdn-core-9.cisco.com (8.15.2/8.15.2) with ESMTPS id xABGwBNx030611 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Mon, 11 Nov 2019 16:58:11 GMT
Received: from xhs-rcd-002.cisco.com (173.37.227.247) by XCH-RCD-011.cisco.com (173.37.102.21) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Mon, 11 Nov 2019 10:58:10 -0600
Received: from xhs-rcd-002.cisco.com (173.37.227.247) by xhs-rcd-002.cisco.com (173.37.227.247) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Mon, 11 Nov 2019 10:58:05 -0600
Received: from NAM02-CY1-obe.outbound.protection.outlook.com (72.163.14.9) by xhs-rcd-002.cisco.com (173.37.227.247) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Mon, 11 Nov 2019 10:58:04 -0600
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=H74gyi2/Nj6bfN+utf/2XQq9d8wPZEtP6NZKE1VKxpMkxExSyQozz+6Iwa4biNBEnBL5eVhuEbJ8tJ2eruJMm2/BrEuYydtJtmJfBqpkrk5hGR3mZzAVQzIejEWYNaAE6gqgn4qUxYMQOy7MpG43sDlwMjiiM3w9bajoM0RJ2UYMvfJY/kUhYN68o5W7AbdIbfCoWRZ3O6f31llextSKaUgYpZZGeqXjQKKus35r75cI0JaB3+FEUddvKgYcq0pkFYfJX6o3iN+R60UyZti4UznT2VFCWu4a8YSWU5J2PDEKvM9RHro6zXW8HmlY+ecgldsO2JQzyT8sq/JgfFtEtg==
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=xVShzeTVUmQ2MHzHWOcO3iaEo57GH26FiTT7zHTWP9w=; b=JUTyeosG4+nvNdFLxzagGvG9kAnA1N8x+SQs7ex9SRqiTDlZaNpboqx8lPJbTEaDvNXRsmeJWRGbefC7yGbf9ui4cnUEZFr5WpoOmFfdPbfKmyOv6OyJjbliucgg+Q01rej+jStpA4Z/cJCN8Hs9/OM+hB3W3eimOvIhqQTOrGjfpWuYdXbvrEUVCDdRscjzWvl+rqMq5eP3fDJAaIfjFAirMq6ygPd3G/Jcuh+Q1bA0PHmW92ULPazZOzhGw9lC8ar9dvVETFuTmKaHBKi0+NcfbD5n2F/TNt4dR24NYTp0agCAt7X1BiuSo/ZP8EIz20N20hHxaJJ5vrNm8JcDWQ==
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=xVShzeTVUmQ2MHzHWOcO3iaEo57GH26FiTT7zHTWP9w=; b=ioxKguTOvAVA70X1zyBdYYqu1CM24d93Lc7gnPQBw1j98FpVu0mUKn9JddhEnl2Pf61stIccnM3NMbjrU/G7aevh4tUtfHcVu3YKaC5wJy658jSrk+wXx3vvyYXTbTJC2K+V8TbQHNjxeYPCR/vauPMKn6D/vUZXtKKasKODtsg=
Received: from MN2PR11MB4157.namprd11.prod.outlook.com (10.255.181.213) by MN2PR11MB4191.namprd11.prod.outlook.com (10.255.180.159) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2430.24; Mon, 11 Nov 2019 16:58:02 +0000
Received: from MN2PR11MB4157.namprd11.prod.outlook.com ([fe80::f030:6ed6:391f:e3eb]) by MN2PR11MB4157.namprd11.prod.outlook.com ([fe80::f030:6ed6:391f:e3eb%5]) with mapi id 15.20.2430.023; Mon, 11 Nov 2019 16:58:02 +0000
From: "Reshad Rahman (rrahman)" <rrahman@cisco.com>
To: "Mr. Jaehoon Paul Jeong" <jaehoon.paul@gmail.com>
CC: YANG Doctors <yang-doctors@ietf.org>, "i2nsf@ietf.org" <i2nsf@ietf.org>, "draft-ietf-i2nsf-registration-interface-dm.all@ietf.org" <draft-ietf-i2nsf-registration-interface-dm.all@ietf.org>, Sangwon Hyun <swhyun77@gmail.com>, "skku-iotlab-members@googlegroups.com" <skku-iotlab-members@googlegroups.com>
Thread-Topic: [I2nsf] Yangdoctors last call review of draft-ietf-i2nsf-registration-interface-dm-04
Thread-Index: AQHVQvTAkkfTX09q5USrQyd4LCPXc6d+Bl8AgAiCPgA=
Date: Mon, 11 Nov 2019 16:58:01 +0000
Message-ID: <47E6993E-1045-4B29-B814-E7185516B272@cisco.com>
References: <156175664267.21931.10329030969352120108@ietfa.amsl.com> <CAPK2DezmXhBA39GFMrU6tYFte_rDK+DE=WyWpzSNFMvnNU+xGQ@mail.gmail.com> <CAPK2Deym5jVmi4JKekRVznpNCkO_x8PN7jz7DLXkgUNZ9V4uUw@mail.gmail.com>
In-Reply-To: <CAPK2Deym5jVmi4JKekRVznpNCkO_x8PN7jz7DLXkgUNZ9V4uUw@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/10.1e.0.191013
authentication-results: spf=none (sender IP is ) smtp.mailfrom=rrahman@cisco.com;
x-originating-ip: [2001:420:2840:1250:6900:eb73:e481:aee6]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: a43e9565-3f97-4084-780f-08d766c85073
x-ms-traffictypediagnostic: MN2PR11MB4191:|MN2PR11MB4191:
x-ms-exchange-purlcount: 4
x-microsoft-antispam-prvs: <MN2PR11MB4191A7C353EA5CDAC7D56D18AB740@MN2PR11MB4191.namprd11.prod.outlook.com>
x-ms-exchange-transport-forked: True
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 0218A015FA
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(979002)(4636009)(346002)(376002)(39860400002)(366004)(136003)(396003)(189003)(199004)(229853002)(54896002)(6306002)(36756003)(46003)(446003)(11346002)(107886003)(6512007)(6246003)(6486002)(6436002)(186003)(71190400001)(5660300002)(76176011)(53546011)(6506007)(486006)(58126008)(54906003)(71200400001)(2616005)(476003)(99286004)(316002)(102836004)(4326008)(6116002)(76116006)(81166006)(81156014)(9326002)(15188155005)(14454004)(25786009)(6916009)(966005)(478600001)(325944009)(2906002)(7736002)(66446008)(14444005)(66556008)(66476007)(256004)(8676002)(86362001)(33656002)(64756008)(66946007)(606006)(8936002)(236005)(16799955002)(969003)(989001)(999001)(1009001)(1019001); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR11MB4191; H:MN2PR11MB4157.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: BCL:0;
x-microsoft-antispam-message-info: V8eKtuYf456AIfzz5ubMkx4iz0wPXW/+wnHB80mmOiJ8gL2Y3b0SSfFodqct3P6df3ySCC9nRauDUopR6ACFK2k1BaDGhyr6eERCMOgGhwKk+OQZuwzb7+lVKmX8vFOcCAhvjc8WSAtPzODzu0BkgYIUN488RLnRGM2F2m6SZK9ToLLO+C3gn2GChZ2W852JIQ4RPKWYYVoVZF0pL9gHryX1x1SMQEUXd0fMBdLzoFneWRzd6Wz8cW/4fEMOuniT5RBdWk+W5geza00nd0Ej3uE6zDLi1scw+wGLMSH/PWVB2/vagOzbYE+URsipr1APxu2d9g+3u1AvHe6eW4XcWWtVrukUtJ9ofv8R1z9s2LcnGS1FuwO/6516JnzVOXtxcIeyvcJDbQS3oDRwmfW2d+IWzOdUzSiv4ZzfKrF2iDSorW5LwEm9yCeXUwWHfTGo9myVgxFDaI1yARu2egX2TDQ+lOd4Tm+7OWrhRIVOyd8=
Content-Type: multipart/alternative; boundary="_000_47E6993E10454B29B814E7185516B272ciscocom_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: a43e9565-3f97-4084-780f-08d766c85073
X-MS-Exchange-CrossTenant-originalarrivaltime: 11 Nov 2019 16:58:02.0174 (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: +i4Ef31YHAR00cworf19SNVvFCRvYe4psd25W2us7TFb6BtEnf+rqJYDJQSCIeL5iPi6O96Z0LI/LoTu+sSxxw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB4191
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.21, xch-rcd-011.cisco.com
X-Outbound-Node: rcdn-core-9.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/TW24rf14WHq0CbFOZaBVAZqmtPI>
Subject: Re: [yang-doctors] [I2nsf] Yangdoctors last call review of draft-ietf-i2nsf-registration-interface-dm-04
X-BeenThere: yang-doctors@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Email list of the yang-doctors directorate <yang-doctors.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/yang-doctors/>
List-Post: <mailto:yang-doctors@ietf.org>
List-Help: <mailto:yang-doctors-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 11 Nov 2019 16:58:16 -0000

Hi Paul,

I have done another review (I don’t think an automated email got sent out).
https://datatracker.ietf.org/doc/review-ietf-i2nsf-registration-interface-dm-04-yangdoctors-lc-rahman-2019-06-28/

YANG Doctor review of draft-ietf-i2nsf-registration-interface-dm-05 (by Reshad Rahman)

Thank you for addressing comments from my earlier review @ https://datatracker.ietf.org/doc/review-ietf-i2nsf-registration-interface-dm-04-yangdoctors-lc-rahman-2019-06-28/

Major comments/questions:
- There is a YANG warning on the datatracker page:
ietf-i2nsf-reg-interface@2019-07-24.yang:54: warning: RFC 8407: 3.1: The IETF Trust Copyright statement seems to be missing (see pyang --ietf-help for details).
To fix this, in the YANG module remove the <> around 2019: Copyright (c) <2019>

- For contact in YANG module, please remove WG chair info (see RFC8407 appendix B for an example)

- For the revision in YANg module, put "Initial version" (even though it's the 5th revision)

- Why define a union of ipv4-address and ipv6-address in typedef nsf-address, why not reuse existing ip-address type from RFC6021?

- For bandwidth, is there a reason why it's limited to uint16? Even though 65Tbps is a lot, I wouldn't limit it to uint16. And aren't there any use-cases for bandwidth smaller than 1 Gbps? If yes, use e.g Mbps as unit and use uint32 instead of uint16? Please use units statement.
- It is not clear to me what’s the distinction between nsf-name and nsf-instance-name. In Examples 4 and 5, they have the same value, but not in Example 3.  Might be worth clarifying or giving the same name.

- Having nsf or i2nsf in many node names is redundant, since NSF or I2NSF is in the higher level container name.  e.g, in NSF Capability Registration all nodes seem to have i2nsf or nsf in their name.

- There seems to be some indentation issues in the YANG  module (e.g. P16)

- Abide by order in RFC8407 Appendix B. e.g. RPC statements should be after groupings.

Nits:

- Appendix B: Managmenet -> Management

- Section 6.2: capailities -> capabilities

- Example 5: space in "http_and_h ttps_flood_mitigation_capability"

Regards,
Reshad.


Regards,
Reshad.

From: "Mr. Jaehoon Paul Jeong" <jaehoon.paul@gmail.com>
Date: Tuesday, November 5, 2019 at 9:02 PM
To: "Reshad Rahman (rrahman)" <rrahman@cisco.com>
Cc: YANG Doctors <yang-doctors@ietf.org>, "i2nsf@ietf.org" <i2nsf@ietf.org>, "draft-ietf-i2nsf-registration-interface-dm.all@ietf.org" <draft-ietf-i2nsf-registration-interface-dm.all@ietf.org>, Sangwon Hyun <swhyun77@gmail.com>, "skku-iotlab-members@googlegroups.com" <skku-iotlab-members@googlegroups.com>, "Mr. Jaehoon Paul Jeong" <jaehoon.paul@gmail.com>
Subject: Re: [I2nsf] Yangdoctors last call review of draft-ietf-i2nsf-registration-interface-dm-04

Hi Reshad,
I believe that I have addressed your comments on I2NSF Registration Interface Data Model:
https://tools.ietf.org/html/draft-ietf-i2nsf-registration-interface-dm-05

If you are satisfied with the revision, could you update the Review result in the following page?
https://datatracker.ietf.org/doc/review-ietf-i2nsf-registration-interface-dm-04-yangdoctors-lc-rahman-2019-06-28/

Thanks.

Best Regards,
Paul

On Thu, Jul 25, 2019 at 11:23 PM Mr. Jaehoon Paul Jeong <jaehoon.paul@gmail.com<mailto:jaehoon.paul@gmail.com>> wrote:
Hi Reshad,
Here is the revision letter for the revised draft, reflecting your comments along with the revised draft:
https://tools.ietf.org/html/draft-ietf-i2nsf-registration-interface-dm-05

If you have further comments and questions, please let me know.

Thanks.

Best Regards,
Paul

On Fri, Jun 28, 2019 at 5:17 PM Reshad Rahman via Datatracker <noreply@ietf.org<mailto:noreply@ietf.org>> wrote:
Reviewer: Reshad Rahman
Review result: On the Right Track

YANG Doctor review of draft-ietf-i2nsf-registration-interface-dm-04 (by Reshad
Rahman)

Major comments:
- Look at appendix B of RFC8407 for an example of how a YANG module should be
structured. This document does not abide to that. - Poor descriptions e.g.
"nsf-name" for leaf "nsf-name" etc - prefix "iiregi" doesn't seem right. What
about "nsfreg"? Probably needs coordination with the other I2NSF YANG modules
to have consistency between the prefixes. I see that YD Acee suggested
"nsfintf" for draft-ietf-i2nsf-nsf-facing-interface-dm-06 - No unit specified
for bandwidth, processing (performance) - nsf-address is IPv4 specific -
Security considerations should list the nodes as per section 3.7 of RFC8407. -
Should this document be informational since 8329 is informational? - Section 2
should use RFC8174 also - Refer to RFC8407 instead of 6807 (YANG Guidelines) -
Examples should use IPv6 as examples (use the range from RFC3849). Kudos for
all the examples.

Minor comments and questions:
- The YANG trees such as Figure 6, 7 etc don't show the contents of the
groupings. So they don't help much. - nsf-port-address should be nsf-port? -
Section 4, last bullet. I am not an expert on I2NSF so not clear to me why this
query is needed, is it because NSF may not re-register after their capabilities
have been updated? Might be worth adding some explanation. - Have the examples
been validated?

_______________________________________________
I2nsf mailing list
I2nsf@ietf.org<mailto:I2nsf@ietf.org>
https://www.ietf.org/mailman/listinfo/i2nsf


--
===========================
Mr. Jaehoon (Paul) Jeong, Ph.D.
Associate Professor
Department of Software
Sungkyunkwan University
Office: +82-31-299-4957
Email: jaehoon.paul@gmail.com<mailto:jaehoon.paul@gmail.com>, pauljeong@skku.edu<mailto:pauljeong@skku.edu>
Personal Homepage: http://iotlab.skku.edu/people-jaehoon-jeong.php<http://cpslab.skku.edu/people-jaehoon-jeong.php>


--
===========================
Mr. Jaehoon (Paul) Jeong, Ph.D.
Associate Professor
Department of Software
Sungkyunkwan University
Office: +82-31-299-4957
Email: jaehoon.paul@gmail.com<mailto:jaehoon.paul@gmail.com>, pauljeong@skku.edu<mailto:pauljeong@skku.edu>
Personal Homepage: http://iotlab.skku.edu/people-jaehoon-jeong.php<http://cpslab.skku.edu/people-jaehoon-jeong.php>