Re: [OPSAWG] [IETF-OPSAWG-WG/lxnm] inbound/outbound terminology (Issue #353)

Julian Lucek <jlucek@juniper.net> Fri, 29 October 2021 11:08 UTC

Return-Path: <jlucek@juniper.net>
X-Original-To: opsawg@ietfa.amsl.com
Delivered-To: opsawg@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id EF7D93A10F9; Fri, 29 Oct 2021 04:08:19 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.12
X-Spam-Level:
X-Spam-Status: No, score=-2.12 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=juniper.net header.b=1YIz1Kup; dkim=pass (1024-bit key) header.d=juniper.net header.b=MeVBNCVA
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 xPprl_lbERvH; Fri, 29 Oct 2021 04:08:14 -0700 (PDT)
Received: from mx0a-00273201.pphosted.com (mx0a-00273201.pphosted.com [208.84.65.16]) (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 9194E3A10F6; Fri, 29 Oct 2021 04:08:14 -0700 (PDT)
Received: from pps.filterd (m0108156.ppops.net [127.0.0.1]) by mx0a-00273201.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 19SNaOdi018192; Fri, 29 Oct 2021 04:08:09 -0700
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=juniper.net; h=from : to : subject : date : message-id : references : in-reply-to : content-type : content-id : content-transfer-encoding : mime-version; s=PPS1017; bh=heeXiQCamjS8AhSmRrIyaae6AHxhgtAWIC2+xFeKs70=; b=1YIz1Kupgr6yXkUn27BHztENmams5H4d7HoC4q/k6GAqwEe6iccwViOQL/Zif21yhbgq 3umVPzY/4ND/Z7wQ1JRt6VyHiQbI5S9VXDF0bnQR+I0ydi3jC5YBVVvLK/GF/+Ik5b3U s3m1Y28jvV3MfWUDAqp2nvuDS0DK2YL5F4hMmjlH+0cs5ULcEBvBIkrQKpj0fiDC4t7W 7b/PxDEsXyUCjmflzx9UFFBM0dufaVgvFO0ahMB9nGvbtLCOOQ3lZgUZvyc9EjPuDBl2 Cv6ATY6pi3kehgkIT75GGmwNzT3xOZIw/+ZadRQJWn8gBBS5RZ1Lt9F+6WhdJUS+n/n/ yQ==
Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2168.outbound.protection.outlook.com [104.47.55.168]) by mx0a-00273201.pphosted.com with ESMTP id 3c05pbh29b-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 29 Oct 2021 04:08:09 -0700
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=aEq2EWQDSCN+mxPmPpd6eUWYjUKLtxDYbMtsgDQUGssFvNndIpFDSQZxWQ3/yUwvN404JkeWhl915DCtPlKfO9++s73mP2icCLbH1178D+dctTXDuA6XEMMPbjIhJNQ/AlqZL0HJqlr6X0ZcjRCUDs0p1YsgPLrvbmGL+M1Qwojx2jMrA40Kj2k3xCie+HkEXfOaVnvoZxgz/nQMkAK8EldN9AEyf388M2tAMYj6zdLwJ9XGETMq4yVuSbuNeEvC4W6ZBQqnxi6aJ+jXtGcbvQMDSwmjWe6zHvHeK51Sep1DesAwFKXW937ryV89XI3qvnDaLg4W6dxboT1zFZY47w==
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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=heeXiQCamjS8AhSmRrIyaae6AHxhgtAWIC2+xFeKs70=; b=HqlTVbKYAgLB6a7Ep20fkhwNaqCoIVCFdhL613tzMfOJRPCLz1qM3hQ8TyCfBG1z7qXKNkHG7qhlsy5vFDri2ynp7YCeHGkyXNoBWIysfXcdp16IkwMeMraBhvMaZG/TGtJSCLXjZWr8M6B0R+H/IVdtkQMuix8XFnSW/+sjCANHu5IvTNvH5DqBaXo7EfyHjfJGfleVkJZJytUKcieO+CaxWhRuFSShs1poM9fBM+QiIFic/WXFd2QW8qMfihGWuMYRXEQm+/MK6Q50uuBV4vF97i/3X2GaFEyr3DvUITMO9pF7Y0Scw2rs096NOvN8eTNjPzBkNTbjJqePjcaBxw==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=juniper.net; dmarc=pass action=none header.from=juniper.net; dkim=pass header.d=juniper.net; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=juniper.net; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=heeXiQCamjS8AhSmRrIyaae6AHxhgtAWIC2+xFeKs70=; b=MeVBNCVAi+oMbwdzdSF1ZSkXU7i6YZvWCrzwVlVjk9HzJt77yXEJRbaXCghzK7Iz0S0+o+GYCiqh8NifHZaUgFIBO5pllwTeMv9Ry5236Vn8lv3kNrZ8TuportKaUbUqU1Pq3lGVwEdhno03fYKNL8dlOPbLaqOd228phwD59Cg=
Received: from PH0PR05MB7687.namprd05.prod.outlook.com (2603:10b6:510:2a::23) by PH0PR05MB8366.namprd05.prod.outlook.com (2603:10b6:510:c4::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4669.4; Fri, 29 Oct 2021 11:08:07 +0000
Received: from PH0PR05MB7687.namprd05.prod.outlook.com ([fe80::509e:c6b2:5b8b:1074]) by PH0PR05MB7687.namprd05.prod.outlook.com ([fe80::509e:c6b2:5b8b:1074%9]) with mapi id 15.20.4649.014; Fri, 29 Oct 2021 11:08:07 +0000
From: Julian Lucek <jlucek@juniper.net>
To: "Joe Clarke (jclarke)" <jclarke@cisco.com>, tom petch <ietfc@btconnect.com>, "Joe Clarke (jclarke)" <jclarke=40cisco.com@dmarc.ietf.org>, "mohamed.boucadair@orange.com" <mohamed.boucadair@orange.com>, "opsawg@ietf.org" <opsawg@ietf.org>
Thread-Topic: [OPSAWG] [IETF-OPSAWG-WG/lxnm] inbound/outbound terminology (Issue #353)
Thread-Index: AQHXzLVAxM5WlKx+3UO+u6LZ3fBPfg==
Date: Fri, 29 Oct 2021 11:08:07 +0000
Message-ID: <637FFA80-0DAD-4320-865C-7D22BBB24956@juniper.net>
References: <IETF-OPSAWG-WG/lxnm/issues/353@github.com> <IETF-OPSAWG-WG/lxnm/issues/353/953059202@github.com> <18574_1635424709_617A99C5_18574_414_1_787AE7BB302AE849A7480A190F8B933035436F0E@OPEXCAUBMA2.corporate.adroot.infra.ftgroup> <BN9PR11MB537122A2B999A0D807A0406DB8869@BN9PR11MB5371.namprd11.prod.outlook.com> <AM7PR07MB6248C2107CD7187F468C850AA0869@AM7PR07MB6248.eurprd07.prod.outlook.com> <BN9PR11MB53717F668860605599C2EF00B8869@BN9PR11MB5371.namprd11.prod.outlook.com>
In-Reply-To: <BN9PR11MB53717F668860605599C2EF00B8869@BN9PR11MB5371.namprd11.prod.outlook.com>
Accept-Language: en-GB, en-US
Content-Language: en-GB
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/16.54.21101001
msip_labels: MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_Enabled=true; MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_ContentBits=0; MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_SiteId=bea78b3c-4cdb-4130-854a-1d193232e5f4; MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_ActionId=a9782170-3ea4-4e98-9b5f-6ec7e75d65ad; MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_SetDate=2021-10-28T21:25:24Z; MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_Method=Standard; MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_Name=Juniper Business Use Only;MSIP_Label_0633b888-ae0d-4341-a75f-06e04137d755_Enabled=true;
authentication-results: cisco.com; dkim=none (message not signed) header.d=none;cisco.com; dmarc=none action=none header.from=juniper.net;
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 37bca4ae-5ee5-4c34-8d89-08d99acc62e5
x-ms-traffictypediagnostic: PH0PR05MB8366:
x-microsoft-antispam-prvs: <PH0PR05MB8366797C316A6388C94A1DBACA879@PH0PR05MB8366.namprd05.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-ms-exchange-senderadcheck: 1
x-ms-exchange-antispam-relay: 0
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: BkcAyet63vBPeBFeKxn0aWVu86p18xk1aWYFSlAwWTOrbydKUuhN7mxIioPc1TsUxLMwnlZnfH1JHGg3lvaM3qmEdSXsOig69hoQn6ElS8TfAm8xJKEM5lHYkuJieQJSAuhC5aRAwUkAuJCPDirVbUBFB0xTN1FHono81S/9oQ5VOlZPCHRqt9GtzPZMq9/vH+ktQ/uB1iQvIZu2WmTIW0dNfdolRCeILWzS04K9vCCaWQOxcPfKcEPp2PSZQlcSrnT2sqrg4HMXiG5SO04JsSNxhtp7ufESawWAgbIbYAtcuih94XSymXjqurZT/foDx+6nQEMZ0WQeK/1P1XfA8tusIzlpRkPu0PKOIM6KomIEVg/il1iRDvc7oUEP/RPi3r7tUETCqgByXMfZJA7P3UzZFEwj00MlMmHTP5qKwNBEZEuFvJmEvqRY7wg7XCVxXREVmMpvbuaYnkjNq3BenDOGwFwFu8Qn4c08u6o+DshZiVyw3xSiOPbHN656QQ2ZTDKQL5zJE4FAIOHj1F1SsfAQQpWxY5FQoehlQVd2uVVNCXOFoz9G++mSvlwrqE1FL+gTaChWNFIUcC0GDT71dHnq38sc3h+/BfUczTNXBWGxMtQ9wyqbCiom8FBOpNdG0VwJxqGKhbMCGQ66oBpgl6J2JbPBn81Y04gcHUhTyfNFEN7ZHLVtGLyZW344OqL92RPisejYaPZgMd4w4+fGWKgEu88xABjRDClNdHTOwyv3osXBxkkzjEx7DwSt3CaccL9juSkPAXck3B4yoR4EIkbnEmj6Z70kwm6+OwLNvi8gz8n+UOYS3pFRlHcAe95XptasHNIxH5MFCd6e4D77Ew==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:PH0PR05MB7687.namprd05.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(33656002)(2616005)(508600001)(5660300002)(76116006)(86362001)(91956017)(71200400001)(186003)(8936002)(110136005)(6512007)(966005)(8676002)(122000001)(26005)(6506007)(316002)(36756003)(6486002)(66556008)(66446008)(66476007)(64756008)(66946007)(38100700002)(2906002)(38070700005)(45980500001); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: 1BiSwQu5tovEJObb6LHIYDlP0S9UKS7OKeR7iqBMzCOJz13MX7ISoeJQA8jirYQQU4W/EkrwIiO/cMiVH+I88eOHmTX7VRlyKbUBEqpesv+6iGCHX8Ab+KbzYFsfEf4NBoOuKhMfllKB55lyb+Sm/lbvIAU5wvtHgS8MDMT1QEURhxRrZk8hdX+TrtHHxtyxx30r6craWZPljajUotGg+xdoBUI4Ru2TrXzTTajbGAm85gS6S2I2Od5nXBIrlDYkeFtmz5d+Z6EkwSrMJlQA1I32jvRALJmcAEp1l2wf5iwH5gUIAYNnpJY0V9LkU9R5q9ZpXTQVYOesIgcOL6/EftngMYvobM9rIYhIr0p0Lel23LPCQzdmn4iAF+iepoW5NzXeB0Q16MaJo2vuZvSDb5A2yTnBGd1eDgIOWeq0zSxnoAY4/nG4MrGvt7vE7iMDFgIvb7QYo3A+JK+2o7qOWKZYrlIRnx23JraAhVXaeKSQWvVP5HYrMiA6GcWl9KZdP/FGT3//BaAJu8MJAdWQu4T5UCPxF0NDePRNHY6IhgZkwJyKFNT6dUdr9g+W5Tngb4BZGuAPpdBP+ulGocseLeGeO4ylC/7Kvt0pviQgX+IeD4GNTn8/kKPkrTO9DgNAMSEK/j+P6a0gYbetBcKDCf9c3KN+LTsd35P2CFVSsYF2v0ApxKQo75rmeeg1qfbTCet9jxMHVKR2ehRy613YSETwsq6bV1bPUkjR4ch09CcQzuZIh5CL0ey8w+CRway0w+CpIyEp5jXe8qB2H+Eh/V6sKH3TGoxPwUcpvhXGCWJWrNoTHCrjrYLCMeFZWiRqP+pEBugkNGKNzdIOMaoymWwdaqA0qsZ7Bf2WmsGDtcXHZ7oyQe+0cGl5lM9deQ66u9C3zhVLsH2uGHJEfAbAffAeOvxBHsyRvtmxMRXnrkWybAKuP+2tnSTvoLBpA96OSCoRUDHberFK7XNk3zpNPpCNz6Uz1SL1z27R9c35kCTw+13a+R1+ySSZ7k4JYfiVVY/cyowdBPAox/pQrYAzCQC7IWUk36hnI+XFPNHn/c1JzW3MfX3vo712YV6UH/nB+d4SBJ3slXmzAEfSeFSdIN0uFOp+50Se5LCcJNmLg0VK9MqrJbc99OT9G70FRh7SCiMpey5HgrK7uTGGqB9LGpDX0A7w7v9UbaANMGJ1kBZRHodaU7XAkRt+fhWgWYyJDn5zT0zERzLjU18zP07SXKGg76HckVGWBYwTRwp2JKhsu1Q8KL7+sVROD/j/0PxzRw0PpP3j20HnR3dMfvdZCisXwG24q31h19zaV+xWpgNoz+ih0wUW9LFPOXKG9xhzLKNba/1/uh6Hrr8npLvF7i3S3ReuFhp0DPupAd+g55LAuj9Hx19XfPhJG0egwEgaCYl0MSXtQetfk0AFIfah9rSzMIzH4IhhtFPHnLnKeUZev2LAbfWIzor4Lw4TCaBqLwGWU0wGlD/N+ziPcZPzq/WGLR+9VRfs3RtRdHiihdvdUL7wV59h2eZrcKSOwtglEjrAg5izr4PpL/VboCGNPeeNcoKh+vAsjEZjlFmKIhV9lSu1/3Fr4ah4LfDFH8vebvsEr3fNDx2NsWlK1ERhXpvLRSISW8Ibrm35yNEc9Qk=
Content-Type: text/plain; charset="utf-8"
Content-ID: <79811167727FE74F802D168305C42E1C@namprd05.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-OriginatorOrg: juniper.net
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: PH0PR05MB7687.namprd05.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 37bca4ae-5ee5-4c34-8d89-08d99acc62e5
X-MS-Exchange-CrossTenant-originalarrivaltime: 29 Oct 2021 11:08:07.0911 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: bea78b3c-4cdb-4130-854a-1d193232e5f4
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: mVNLruNK3WHiBnzXo3E+SeM8iRU1cOOE5t/S0yXznYwoniYV9nApA1j97BU04iGolUv+eNJAfI31cetxa4B+zA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR05MB8366
X-Proofpoint-ORIG-GUID: 7_OWmSAbfFsK-eecWHNkF0vawdS4NR6T
X-Proofpoint-GUID: 7_OWmSAbfFsK-eecWHNkF0vawdS4NR6T
X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.182.1,Aquarius:18.0.790,Hydra:6.0.425,FMLib:17.0.607.475 definitions=2021-10-29_02,2021-10-29_01,2020-04-07_01
X-Proofpoint-Spam-Details: rule=outbound_spam_notspam policy=outbound_spam score=0 malwarescore=0 priorityscore=1501 lowpriorityscore=0 clxscore=1011 suspectscore=0 phishscore=0 bulkscore=0 mlxscore=0 mlxlogscore=999 impostorscore=0 spamscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2110150000 definitions=main-2110290064
Archived-At: <https://mailarchive.ietf.org/arch/msg/opsawg/05u16Ex61UzndM2_E0uhbPLngUQ>
Subject: Re: [OPSAWG] [IETF-OPSAWG-WG/lxnm] inbound/outbound terminology (Issue #353)
X-BeenThere: opsawg@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: OPSA Working Group Mail List <opsawg.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/opsawg>, <mailto:opsawg-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/opsawg/>
List-Post: <mailto:opsawg@ietf.org>
List-Help: <mailto:opsawg-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/opsawg>, <mailto:opsawg-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 29 Oct 2021 11:08:20 -0000


    > “But I would urge you to change the terminology to "PE-to-CE-bandwidth" /"CE-to-PE-bandwidth" to make it super-explicit, the current terminology has been causing endless confusion to implementers (I realise it's inherited from the service models, but changing the terminology in LXNM would cure the problem well)”
    > All, Julian raised early this week a comment about an L2NM terminology we are inheriting from the service model. The full context of this discussion can be seen at: https://urldefense.com/v3/__https://github.com/IETF-OPSAWG-WG/lxnm/issues/353__;!!NEt6yMaO-gk!ReRxmR5F6z_pKtX7BhgdObWeu4Fcy-LBM0ZthSDuvFlmOdmDYHq0tMvAIHpYPusN$ .
    >
    > As a contributor, reading the current draft text in conjunction with the YANG model description, I agree with Julian.  It's confusing.  Typo aside, I had to jump back and forth a couple of times to grok things correctly.  Aligning the terminology in the module with text in Section 7.6.4 in terms of CE vs. PE and direction would help.
    >
    > <tp>
    >
    > Or you could align it with l3nm where a similar issue was raised and the wording was changed to make it clearer.  The wording does not use PE or CE, and is the wording that that the  IESG has approved!

    Yes, I see what you mean.  They were very clear in those descriptions,
    even addressing the SM discrepancies.

    Joe

It would be highly preferable for the leaf names to be self-explanatory, for the benefit of those reading the model itself or using auto-generated structures derived from it. In v18 of the l3nm, the leaf names are "inbound-bandwidth" and "outbound-bandwidth" so one needs to read the description to understand from whose perspective those directions are.

Julia


Juniper Business Use Only