Re: [Rift] Final pass on readability/normative ...

"Pascal Thubert (pthubert)" <pthubert@cisco.com> Tue, 07 January 2020 15:57 UTC

Return-Path: <pthubert@cisco.com>
X-Original-To: rift@ietfa.amsl.com
Delivered-To: rift@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 1C038120059 for <rift@ietfa.amsl.com>; Tue, 7 Jan 2020 07:57:38 -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=hf2z/3lC; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=jdmjSOrj
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 kEUjf1ZxlnGx for <rift@ietfa.amsl.com>; Tue, 7 Jan 2020 07:57:32 -0800 (PST)
Received: from rcdn-iport-1.cisco.com (rcdn-iport-1.cisco.com [173.37.86.72]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id BBF7E1200E0 for <rift@ietf.org>; Tue, 7 Jan 2020 07:57:31 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=34976; q=dns/txt; s=iport; t=1578412651; x=1579622251; h=from:to:cc:subject:date:message-id:references: in-reply-to:mime-version; bh=Op34ltgwWO3wz5d2aHs2vXmXvqUUgt+RutjYisig5qQ=; b=hf2z/3lCmmOC9v3YV+QwHXQJIKXrHPJuF9yVuMSd7NGWXYFlbb1C+r6u js+rr01gShNYQ1M8QSQRLVW3JCxuRwznnh9ADOmAzoA/J4p7aMj4qgCXz Vkjn0Bun4ZR0aoAZBTFtgfLDpSSB4sWVujkHXOZW9/wAyvDxbfNvO3K6m A=;
IronPort-PHdr: 9a23:yNhsIxGh2YDZsQ1d2lWG551GYnJ96bzpIg4Y7IYmgLtSc6Oluo7vJ1Hb+e4z1Q3SRYuO7fVChqKWqK3mVWEaqbe5+HEZON0pNVcejNkO2QkpAcqLE0r+eeb2bzEwEd5efFRk5Hq8d0NSHZW2ag==
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0CsBQC9qRRe/5hdJa1gBhwBAQEBAQcBAREBBAQBAYF8gSUvJCwFbFggBAsqhAmDRgOLBYJfmA2CUgNUCQEBAQwBAR8OAgEBhEACF4FSJDgTAgMNAQEEAQEBAgEFBG2FNwyFXgEBAQEDEhEEBhMBATIFAQ8CAQgRBAEBIQcDAgICMBQJCAIEDgUIGoMBgXlNAy4BAgyhSQKBOIhhdX8zgn4BAQWFBxiCDAMGgTaFHYZ8GoFBP4EQAUdRgXs+gmQBAQOBOhgQJAcJgloygiyQQYVXiWWPJgqCNoc1jwKCR4d9kBuXJ5INAgQCBAUCDgEBBYFpIoFYcBWDJ1AYDY0Sg3OFFIU/dIEoinOCQgEB
X-IronPort-AV: E=Sophos;i="5.69,406,1571702400"; d="scan'208,217";a="693102745"
Received: from rcdn-core-1.cisco.com ([173.37.93.152]) by rcdn-iport-1.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 07 Jan 2020 15:57:30 +0000
Received: from XCH-RCD-010.cisco.com (xch-rcd-010.cisco.com [173.37.102.20]) by rcdn-core-1.cisco.com (8.15.2/8.15.2) with ESMTPS id 007FvUgg025090 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Tue, 7 Jan 2020 15:57:30 GMT
Received: from xhs-rtp-003.cisco.com (64.101.210.230) by XCH-RCD-010.cisco.com (173.37.102.20) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 7 Jan 2020 09:57:29 -0600
Received: from xhs-rcd-003.cisco.com (173.37.227.248) by xhs-rtp-003.cisco.com (64.101.210.230) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Tue, 7 Jan 2020 10:57:28 -0500
Received: from NAM02-CY1-obe.outbound.protection.outlook.com (72.163.14.9) by xhs-rcd-003.cisco.com (173.37.227.248) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Tue, 7 Jan 2020 09:57:28 -0600
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=CUQGZYjfHMzEZIa62CF/gCUl1mLssa2X6uQ1QWYxLWKiVOjZ0EfTz3dZ9L/CRgFwfZNVdwE5or7LkwfNR2rN6QOlv5lAj4LU1DDnp/c/bJ1UmaOBayX8xle+DwB+83kACzwhgkWXWGE/foNfuUyrtTJl1mWLMoB03wfMru/+5CAegKfJ0MeUi4VdpbwUl50ovKmNr+7UUNoROGB2fhXRypbY1xknzIGSA1GWohEhL/Nzkh0W+WTc+7BF/jjMQABMk3M8JdE170Fjx5vn2wMpNZJnIXQWo5LrZVK3uO0BCvUozGBhe2W+6Ea+uXL7Zh5BG5v7yL0PAgYgTeTHqg5j7g==
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=Op34ltgwWO3wz5d2aHs2vXmXvqUUgt+RutjYisig5qQ=; b=X4Fm0IlCjRgZu5plrYUIFlJXo2YZQZIdcBtMjxoOo8G3BXDRPewDXlZxl7iFR6C5J1924uqADp5ov/2Zoe8VSfDmwhhrsFdmt/Ewn4Z2ivsQ1jemV4uL7l0MkArh6SEqKNO6T2UyvP16WkkiG73pk11KS6/c5J8b4+aYIaiTvd/p1dIOWq8d4PM9r0YsoIRzGtg0p6WRvs1zEftw603ZeDjK1iy27NW/BMqzcIqz++F5fKo0hy3xpO7yhtlibHwHxwMltMzSqbYm4esTI0yMLDBQ1O3yJKtwjJFVJbstZAj9d2LqV96zI6MiO7wjfniA+0SGaVA85kB7sKb5EzF3gA==
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=Op34ltgwWO3wz5d2aHs2vXmXvqUUgt+RutjYisig5qQ=; b=jdmjSOrjmjZmw4tkQR9pBBHGd6vs/cBX85uJfDYDFtJ2Pqy19DGnODeIX+vWkie0D2wLey3Ok+ke7Qua7kktoY6CEVixRCA9NCwr2tOu39NPcadrCpW36qwbwt/1rmzCymMszPNhj0WyMyKFYxlsOnzjH74w+OqXmEqnf4WYlRQ=
Received: from MN2PR11MB3565.namprd11.prod.outlook.com (20.178.250.159) by MN2PR11MB4192.namprd11.prod.outlook.com (10.255.180.25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2602.12; Tue, 7 Jan 2020 15:57:27 +0000
Received: from MN2PR11MB3565.namprd11.prod.outlook.com ([fe80::fd76:1534:4f9a:452a]) by MN2PR11MB3565.namprd11.prod.outlook.com ([fe80::fd76:1534:4f9a:452a%3]) with mapi id 15.20.2602.015; Tue, 7 Jan 2020 15:57:27 +0000
From: "Pascal Thubert (pthubert)" <pthubert@cisco.com>
To: Tony Przygienda <tonysietf@gmail.com>
CC: "rift@ietf.org" <rift@ietf.org>
Thread-Topic: [Rift] Final pass on readability/normative ...
Thread-Index: AQHVrlkD26MeEFPSo0Kd+sHHMEpUmKexXyYAgA5HkoCAAAWGIIAfrrRQ
Date: Tue, 07 Jan 2020 15:57:10 +0000
Deferred-Delivery: Tue, 7 Jan 2020 15:57:00 +0000
Message-ID: <MN2PR11MB356571D181C7130CC84A5E37D83F0@MN2PR11MB3565.namprd11.prod.outlook.com>
References: <CA+wi2hPV7GvA7unqded=WYf2DDm0CnWCx0ygGjD2G2JpNwJhTg@mail.gmail.com> <MN2PR11MB356573C857961433E29D35FAD8580@MN2PR11MB3565.namprd11.prod.outlook.com> <CA+wi2hP-C4LtO1T0t=vON6Wv55PS_DU9JrtUrsnBFMw+hR5qaA@mail.gmail.com> <BYAPR11MB3558E4A0178B5CC92D20D6D2D8530@BYAPR11MB3558.namprd11.prod.outlook.com>
In-Reply-To: <BYAPR11MB3558E4A0178B5CC92D20D6D2D8530@BYAPR11MB3558.namprd11.prod.outlook.com>
Accept-Language: fr-FR, en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=pthubert@cisco.com;
x-originating-ip: [2001:420:44f3:1300:41e7:7725:e525:b2e8]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 87f0446f-9492-439a-e81e-08d7938a4b47
x-ms-traffictypediagnostic: MN2PR11MB4192:
x-microsoft-antispam-prvs: <MN2PR11MB4192CB7F27BCADF0C0A17C65D83F0@MN2PR11MB4192.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:3383;
x-forefront-prvs: 027578BB13
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(136003)(376002)(346002)(396003)(366004)(39860400002)(189003)(199004)(186003)(6666004)(2906002)(7696005)(8676002)(81156014)(81166006)(478600001)(71200400001)(6506007)(53546011)(5660300002)(8936002)(66574012)(66446008)(64756008)(9686003)(6916009)(33656002)(4326008)(66946007)(52536014)(66476007)(316002)(66556008)(86362001)(76116006)(55016002)(21314003); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR11MB4192; H:MN2PR11MB3565.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: Rt09kjvBqt48o7OpySNXlaVKPmC1XhuzkLdm+KF4z8epuhZIbhW/mLNmHsAIs0W6JQxmJC9pchZqoUXS5t8xHzFTZWvQPeeu1g5Uz1dD4lf+AKTgGJsmx+0kbbuAnsG8pHOCGTvTkfx3ies/2g9cC0DARrFZPNTbwT8+iqUcOKbhPPoXg/ruPheRakRJcB2W11j6ZgFBiKG77VLLKiK5SdEirMtL4MkSdzDQiNIuo2kieGHB9g+UWy3dDRUH7KLoSMhBDbEX2C34zajWKlHqYRt9FpviDLTvHg56Bvx/0UZj1G6ahuJ2uhBkgxFWjYYO3nGapQtr8KDKdtQ2NCnUS6Vm0cY60/UXxElrheQHhYu7Ds0NEgrpqUNBQhm7kW2dlKKLKZfDDQKwL9H9CuDtv6KLQorR/pqf8CxXHcqIr3y0BySbEZRRrNXA5jPM/ThDAFix4EdrbTYdzZ/h2RL4kESwY5qFYRYr7+X+kJ/YKmpBWXz5ZNUllASf3svfMK2QbgTaoKfdPsRY0pXZEsNCfQ==
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_MN2PR11MB356571D181C7130CC84A5E37D83F0MN2PR11MB3565namp_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 87f0446f-9492-439a-e81e-08d7938a4b47
X-MS-Exchange-CrossTenant-originalarrivaltime: 07 Jan 2020 15:57:27.1859 (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: 2kYjdRS6F13haYKx1a5oyJS/A4+vb5Y/bbGm7ks2IHdn/DCM4MBMJw/5KuSfFc8IYNeRTtin7yGXnFCR2k9Dcw==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR11MB4192
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.20, xch-rcd-010.cisco.com
X-Outbound-Node: rcdn-core-1.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/rift/f3VnvmGPaZo7-_jl7EM_xzp6qPA>
Subject: Re: [Rift] Final pass on readability/normative ...
X-BeenThere: rift@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Discussion of Routing in Fat Trees <rift.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rift>, <mailto:rift-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rift/>
List-Post: <mailto:rift@ietf.org>
List-Help: <mailto:rift-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rift>, <mailto:rift-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 07 Jan 2020 15:57:38 -0000

Hello Tony:

As promised:


      Superspine/Aggregation or Spine/Edge Levels:  Traditional names in
      5-stages folded Clos for Level 2, 1 and 0 respectively.  Level 0
      is often called leaf as well.  We normalize this language to talk
      about leafs, spines and top-of-fabric (ToF).

I believe we should reword this, maybe as below:

      Superspine vs. Aggregation or Spine vs. Edge or Leaf:  Traditional level
      names in  5-stages folded Clos for Level 2, 1 and 0 respectively.  We
      normalize this language to talk about top-of-fabric (ToF), top-of-pod (ToP)
      and leaves.


   De-aggregation/Disaggregation:  Process in which a node decides to
      advertise certain prefixes it received in North TIEs to prevent
      black-holing and suboptimal routing upon link failures.

Suggestion:

   De-aggregation/Disaggregation:  Process in which a node decides to
      advertise more specific prefixes Southwards, either positively to
      attract the corresponding traffic, or negatively to repel it.
      Disaggregation is performed to prevent black-holing and suboptimal
      routing to the more specific prefixes.


   Bandwidth Adjusted Distance (BAD):  This is an acronym for Bandwidth
      Adjusted Distance.  Each RIFT node calculates the amount of
      northbound bandwidth available towards a node compared to other
      nodes at the same level and modifies the default route distance
      accordingly to allow for the lower level to adjust their load
      balancing towards spines.

Removing the first sentence:

   Bandwidth Adjusted Distance (BAD):  Each RIFT node calculates the
      amount of northbound bandwidth available towards a node compared
      to other nodes at the same level and modifies the default route distance
      accordingly to allow for the lower level to adjust their load
      balancing towards spines.



   North SPF (N-SPF):  A reachability calculation that is progressing
      northbound, as example SPF that is using South Node TIEs only.

I think it is confusing to call the northbound computation a SPF since it is a 1 hop calculation. Relates to the next point:



   We present here a detailed outline of a protocol optimized for
   Routing in Fat Trees (RIFT) that in most abstract terms has many
   properties of a modified link-state protocol
   [RFC2328<https://tools.ietf.org/html/rfc2328>][ISO10589-Second-Edition] when "pointing north" and distance
   vector [RFC4271<https://tools.ietf.org/html/rfc4271>] protocol when "pointing south".  While this is an
   unusual combination, it does quite naturally exhibit the desirable
   properties we seek.


I’d replace "pointing north" with computing southbound routes and reciprocally for "pointing south" with computing northbound routes.


PoD-ToP
->
ToP
(twice)


|H<
  ->
|o<


LIEs SHOULD be sent with a TTL of 1
->
LIEs SHOULD be sent with an IPv4 Time to Live (TTL) / IPv6 Hop Limit (HL) of 1

(same addition suggested in 4.2.3.1 for LIE)

Nodes in the spine are configured with "any" PoD which has the same
   value "undefined" PoD hence we will talk about "undefined/any" PoD.
   This information is propagated in the LIEs exchanged.

“Nodes in the spine” is unclear; do you mean ToF nodes? My understanding is that: ToF nodes MUST be configured with “undefined”, ToP MUST NOT be configured with “undefined”, and a leaf node MAY be configured with “undefined”, in which case the leaf node learns from its ToP parents. (If I’m correct) maybe we should say just that?


This will not affect the correctness of the protocol expect preventing detection of certain miscabling cases.
-> s/expect/except/
This will not affect the correctness of the protocol except preventing detection of certain miscabling cases.


normally the top spines in a PoD
->
normally the ToP nodes


4.2.2.1.  LIE FSM

Maybe listing the states in after the first sentence would be useful for the reader? Also introduce HAL, HALS and HAT acronyms before using them?
Also, the terms “lie” and “cleanup” are found in lowercase, maybe change all relevant to uppercase


“More precisely, a spine node represents two different”
Should we remove “spine” from  the sentence? Or define it?
Same goes for the use of “Spine xxx”, should we call them ToP xxx?


4.2.3.  Topology Exchange (TIE Exchange)

Maybe indicate that TIEs are exchanged only in 3-ways?




Suggestion to add an “instance nb” to the TIE so we can build multiple RIBs like in RPL over a same topology, e.g.; to serve different tenants.



More tomorrow, starting at 4.2.3.3.1.5

All the best

pascal



From: RIFT <rift-bounces@ietf.org<mailto:rift-bounces@ietf.org>> On Behalf Of Tony Przygienda
Sent: dimanche 8 décembre 2019 22:21
To: rift@ietf.org<mailto:rift@ietf.org>
Subject: [Rift] Final pass on readability/normative ...

Only IESG outstanding reviewer's comments on the spec are @ this point in time improving general readability & fine comb on normative captions (plus going to format -v3 with pictures is up to me)

I have some volunteers already that are starting on reading sections & polishing, I'm calling here for more ;-) If you'd like to review a section for readability & check normative language please contact me and I'll synchronize. Resolution is X.Y or X.Y.Z section with exception of small stuff like Examples maybe.

On offer honorable mention in the acknowledgements section ;-)

Idea would be to have a -10 (hopefully last one) with pictures & review incorporated before next IETF.

thanks

-- tony