Re: [Gen-art] Gen-ART Last Call review of draft-ietf-ospf-two-part-metric-05

Brian E Carpenter <brian.e.carpenter@gmail.com> Mon, 08 August 2016 20:18 UTC

Return-Path: <brian.e.carpenter@gmail.com>
X-Original-To: gen-art@ietfa.amsl.com
Delivered-To: gen-art@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 87DD612D09C; Mon, 8 Aug 2016 13:18:55 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2
X-Spam-Level:
X-Spam-Status: No, score=-2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
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 HZ4fewCwnN_G; Mon, 8 Aug 2016 13:18:53 -0700 (PDT)
Received: from mail-pa0-x229.google.com (mail-pa0-x229.google.com [IPv6:2607:f8b0:400e:c03::229]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id B8DBB12B078; Mon, 8 Aug 2016 13:18:53 -0700 (PDT)
Received: by mail-pa0-x229.google.com with SMTP id iw10so116752988pac.2; Mon, 08 Aug 2016 13:18:53 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=subject:to:references:from:organization:message-id:date:user-agent :mime-version:in-reply-to:content-transfer-encoding; bh=odetUxzy0g44xB+3jNQb6Xy24TRPtIuWmlBiX+7HLOE=; b=HH8WExvmDJGIwFpys22VCHpWcCE4AmHAFp+bb67yni8O+5yOG79M6vtIJosC6gut66 8qSZ6s/UzKiIoYAg5xcpLTB+OwgU447WbumjwJN6qcKk7MXvW4edD+DIHobXc0c3L325 jzyi4rj1aCVUbo0WZ5WsgWGX5XqsDgRm+6Sg4/t/zlurQ2C2+wCaIFtcy7JAV0Sdf6Kq FMR6XmoJFah/cmuI459ufD33zGx69/gCzjwSemeBv8jfpSavKs1Yh4thtqyjoCzr4dn5 JrJWcv7fS7MPlCp8/qR3m0UBfcrLWe114mAt/2TzS2tW4M6NSXNPZz2kvgI87EFYhSyy z7+g==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:subject:to:references:from:organization :message-id:date:user-agent:mime-version:in-reply-to :content-transfer-encoding; bh=odetUxzy0g44xB+3jNQb6Xy24TRPtIuWmlBiX+7HLOE=; b=YhiykG3Ec/nuG0fmJgPEvz7/SNAsNABVW/oaFBmXuL/Q5psSzcsYi35VvMD5q9otB6 ycIbHHWg6gNpHjVbBEP8O5M3wiUNe1yz3/JBGvITZN2AxJF0yYasageYMEio8wX9lXKC 7T50AIG7D1lsWKdxj4AVUf/a9XH6yNnHOVp7G5JdlFCjS0iY6Geha7CRDisgTqCvI9t3 bxPyqe+Q0a/zemjj7A6aGmzzMtzWBO0zPcMQ1DKsWM2xre6XQyLtvFHfmI25tt/uLNQM z/c9uYCGjHhGOX4iDc9jS3eLBzPWTvK7FtodCxo0vaDsivW9x44P/5fpgpa/OZElG0BV mxIA==
X-Gm-Message-State: AEkoouuDIKqSphVTScHFVr+r8Cp9s/sEk1UxMz5+by+A5XFOIa2VR1CkCsxheWdEwNrOvw==
X-Received: by 10.66.157.40 with SMTP id wj8mr164008667pab.53.1470687533168; Mon, 08 Aug 2016 13:18:53 -0700 (PDT)
Received: from [192.168.178.23] (169.216.69.111.dynamic.snap.net.nz. [111.69.216.169]) by smtp.gmail.com with ESMTPSA id e2sm50166654pfd.45.2016.08.08.13.18.50 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 08 Aug 2016 13:18:52 -0700 (PDT)
To: "Acee Lindem (acee)" <acee@cisco.com>, "draft-ietf-ospf-two-part-metric.all@ietf.org" <draft-ietf-ospf-two-part-metric.all@ietf.org>, General Area Review Team <gen-art@ietf.org>
References: <4ee8e895-a939-d747-a82f-fb7c8696b36e@gmail.com> <D3CE3687.7666E%acee@cisco.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Organization: University of Auckland
Message-ID: <7b3e0da4-2cf9-d91d-d179-1d6179c0f9b3@gmail.com>
Date: Tue, 9 Aug 2016 08:18:50 +1200
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0
MIME-Version: 1.0
In-Reply-To: <D3CE3687.7666E%acee@cisco.com>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Archived-At: <https://mailarchive.ietf.org/arch/msg/gen-art/60s9q8M2fGueYs83CWOwKoGn8xM>
Subject: Re: [Gen-art] Gen-ART Last Call review of draft-ietf-ospf-two-part-metric-05
X-BeenThere: gen-art@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: "GEN-ART: General Area Review Team" <gen-art.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/gen-art>, <mailto:gen-art-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/gen-art/>
List-Post: <mailto:gen-art@ietf.org>
List-Help: <mailto:gen-art-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/gen-art>, <mailto:gen-art-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 08 Aug 2016 20:18:55 -0000

Hi Acee,

Thanks, just a few points in line:

On 09/08/2016 05:47, Acee Lindem (acee) wrote:
> Hi Brian, 
> 
> Thanks much for the thorough review. Jeffrey and I discussed your comments
> this morning. See responses to your major/minor comments below. We will
> incorporate all the nits.
> 
> On 8/6/16, 9:38 PM, "Brian E Carpenter" <brian.e.carpenter@gmail.com>
> wrote:
> 
>> I am the assigned Gen-ART reviewer for this draft. The General Area
>> Review Team (Gen-ART) reviews all IETF documents being processed
>> by the IESG for the IETF Chair.  Please treat these comments just
>> like any other last call comments.
>>
>> For more information, please see the FAQ at
>> <http://wiki.tools.ietf.org/area/gen/trac/wiki/GenArtfaq>.
>>
>> Document: draft-ietf-ospf-two-part-metric-05.txt
>> Reviewer: Brian Carpenter
>> Review Date: 2016-08-07
>> IETF LC End Date: 2016-08-15
>> IESG Telechat date:
>>
>> Summary: Almost ready
>> --------
>>
>> Major issues:
>> -------------
>>
>>> Updates: 2328, 5340 (if approved)
>>
>> If that is so, the text needs to explain what is changed in those two
>> RFCs. Since
>> this draft describes an "optional extension" to OSPF, it does not
>> obviously update
>> them. Is any text in those two RFCs made invalid by this draft?
> 
> This has been an ongoing debate as to whether an RFC the augments an
> existing draft updates it or whether it must actually change the existing
> behavior. In this case, the SPF calculation is modified as specified in
> section 3.6 but only when the new Network-to-Router metric is advertised.
> In RFC 2328 and RFC 5340, this cost is always zero (i.e., cost to reach
> all routers connected to the network is solely the outgoing metric metric
> or Router-to-Network metric).

OK, fair comment.

> 
> I, for one, would be very happy to have consensus of precisely what
> constitutes update to an existing RFC. 

So would many people, and since it affects all RFC streams, not just the
IETF stream, I happen to know that the RFC Editor is working on definitions
for both "updates" and "obsoletes".

> If we don’t update the existing
> RFCs, we would avoid the pre-2008 IPR language.

That doesn't seem right. You only need that language if you are updating
whole chunks of older text. If you take a paragraph from a pre-2008 document,
change a few words, and patch it into the new document, you need either
the agreement of the original authors or the pre-2008 disclaimer. But I
don't think you're doing that in this case, are you?

>>> 3.6.  SPF Calculation
>>>
>>>   During the first stage of shortest-path tree calculation for an area,
>>>   when a vertex V corresponding to a Network-LSA is added to the
>>>   shortest-path tree and its adjacent vertex W (joined by a link in V's
>>>   corresponding Network LSA), the cost from V to W, which is W's
>>>   network-to-router cost, is determined as follows:
>>
>> I can't parse that sentence. If we delete the subordinate clauses, we get
>>
>>  When a vertex V is added to the shortest-path tree and its adjacent
>> vertex W,
>>  the cost from V to W is determined as follows:
>>
>> What does that mean? What does "its" refer to? Is W adjacent to V, or is
>> W adjacent
>> to the existing tree? Is W added to the tree before V, or is V added
>> before W?
>> If I was coding this, I'd have no idea what to do.
> 
> You really do have to look at RFC 2328 to understand it. 

Yes, I did that in some detail when I was teaching routing a few years ago ;-)

> Does this
> modified text parse better?
> 
>     The first stage of the shortest-path tree calculation is described
>     in section 16.1 of [RFC 2328] and modified for OSPFv3 as described in
>     section 4.8.1 of [RFC 5340]. When a vertex V corresponding to a
> Network-LSA
>     has just been added to the Shortest Path Tree (SPT) and an adjacent
> vertex W 
>     (joined by a link in V’s corresponding Network-LSA) is being added to
>     the SPT, the cost from V to W (W’s network-to-router cost) is
> determined 
>     as follows:

MUCH better. It also clarifies the "Updates:" aspect.

Thanks
   Brian

> 
>>
>>> 3.7.  Backward Compatibility
>>
>> This calls for a Router Functional Capability Bit assignment under RFC
>> 7770.
>> The bit number should be given as (say) TBD1 not as 0.
>>
>>> 4.  IANA Considerations
>>
>> The IANA considerations ask for four assignments. These should be
>> specified as TBD1,
>> TBD2, TBD3, TBD4 and the TBDs elsewhere in the text should be updated
>> correspondingly.
>> Also, please reference the relevant RFCs (7770 and whatever defines the
>> Sub-TLV registries.)
> 
> 3.7 and 4 are both fixed in -06 based on comments from Alia.
> 
>>
>> Finally, to put this on the standards track, I would really expect to see
>> an Implementation Status section (RFC 7942). Has this been tested?
> 
> The implementation of this stalled. However, it is viewed by the WG as
> straight-forward enough to advance.
> 
> 
>>
>> Minor issues:
>> -------------
>>
>> Please check the three occurrences of lower-case "must" in Section 3.
>> Should they be "MUST"?
>>
>>> 5.  Security Considerations
>>>
>>>   This document does not introduce new security risks.
>>
>> That's easy to say but hard to prove. Shouldn't you at least refer to the
>> security
>> considerations of OSPFv2 and OSPFv3?
> 
> We will add the reference.
> 
>>
>> Also, does section 3.7 introduce a new risk whereby a rogue router could
>> flap its
>> Two-Part Metric bit on and off, causing all its OSPF peers to continually
>> recalculate
>> their routes?
> 
> This is no more of a risk than other intra-area metric change.
> 
> Thanks,
> Jeffrey and Acee 
> 
> 
> 
> 
>>
>> Nits:
>> -----
>>
>>> Requirements Language
>>
>> It's unusual to put this at the front. The normal place is after the
>> Introduction.
>>
>>>  This document may contain material from IETF Documents or IETF
>>>  Contributions published or made publicly available before November
>>>  10, 2008. ...
>>
>> Why is this needed? What did you copy from an old document?
>>
>>> 0 OSPF Two-part Metric [TPM]
>>
>> The abbreviation TPM is defined but not used, so why bother? Also,
>> s/[TPM]/(TPM)/ to
>> avoid confusion with a reference.
>>
>>> routes w/o considering any network-to-router costs.
>>
>> Just say "without".
>