[Gen-art] Gen-ART Telechat review of draft-ietf-opsawg-capwap-alt-tunnel-08

Paul Kyzivat <pkyzivat@alum.mit.edu> Fri, 21 October 2016 15:52 UTC

Return-Path: <pkyzivat@alum.mit.edu>
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 0B7A0129646; Fri, 21 Oct 2016 08:52:39 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.632
X-Spam-Level:
X-Spam-Status: No, score=-4.632 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, RP_MATCHES_RCVD=-0.431, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
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 W7A_2hmeHfp6; Fri, 21 Oct 2016 08:52:35 -0700 (PDT)
Received: from alum-mailsec-scanner-5.mit.edu (alum-mailsec-scanner-5.mit.edu [18.7.68.17]) by ietfa.amsl.com (Postfix) with ESMTP id E1180129653; Fri, 21 Oct 2016 08:52:34 -0700 (PDT)
X-AuditID: 12074411-fddff700000008d0-bd-580a39c1fd49
Received: from outgoing-alum.mit.edu (OUTGOING-ALUM.MIT.EDU [18.7.68.33]) by alum-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP id 5C.0B.02256.1C93A085; Fri, 21 Oct 2016 11:52:34 -0400 (EDT)
Received: from [192.168.1.110] (c-73-186-127-100.hsd1.ma.comcast.net [73.186.127.100]) (authenticated bits=0) (User authenticated as pkyzivat@ALUM.MIT.EDU) by outgoing-alum.mit.edu (8.13.8/8.12.4) with ESMTP id u9LFqWuj004253 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT); Fri, 21 Oct 2016 11:52:33 -0400
To: draft-ietf-opsawg-capwap-alt-tunnel.all@ietf.org
References: <e529d886-eefe-bf21-7bef-99c2add33abf@alum.mit.edu>
From: Paul Kyzivat <pkyzivat@alum.mit.edu>
Message-ID: <f650f9ff-24ff-836f-a2d9-9b8e50b5e43f@alum.mit.edu>
Date: Fri, 21 Oct 2016 11:52:32 -0400
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:45.0) Gecko/20100101 Thunderbird/45.4.0
MIME-Version: 1.0
In-Reply-To: <e529d886-eefe-bf21-7bef-99c2add33abf@alum.mit.edu>
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Transfer-Encoding: 8bit
X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFrrNIsWRmVeSWpSXmKPExsUixO6iqHvIkivCYPV2Zotde9Itrr76zOLA 5LFkyU+mAMYoLpuU1JzMstQifbsEroxVs6czF/xzqlh68AFLA+Mrky5GTg4JAROJDeevsXUx cnEICVxmlLi+bjUzhHOdSaK14TY7SJWwgJfEs98XGUFsEaCOTZ93gNlCAvYS17b0sILYzAL6 En+fLGYCsdkEtCTmHPrPAmLzAtV833aRGcRmEVCVaF36H2ymqECaxPZ1u5khagQlTs58AlbP KeAgsW1mAzvETDOJeZsfMkPY8hLNW2czT2Dkn4WkZRaSsllIyhYwMq9ilEvMKc3VzU3MzClO TdYtTk7My0st0jXVy80s0UtNKd3ECAlDwR2MM07KHWIU4GBU4uFdIcwVIcSaWFZcmXuIUZKD SUmUd9FEzgghvqT8lMqMxOKM+KLSnNTiQ4wSHMxKIrxBpkDlvCmJlVWpRfkwKWkOFiVxXr4l 6n5CAumJJanZqakFqUUwWRkODiUJ3iMWQI2CRanpqRVpmTklCGkmDk6Q4TxAw2VAaniLCxJz izPTIfKnGBWlxHlngSQEQBIZpXlwvbA08YpRHOgVYd7nIFU8wBQD1/0KaDAT0OCaNA6QwSWJ CCmpBsbYlO7y5Ze+K5y8vc/x/YfXz98u374o9Wi4o3nDa/v4P0y3Cu7dcGhfvo//V3P0N6fp HW5tV9yqT7nsnPuoosD54o4Fpy8cuxnyt/eJq6fMsoSThxb9Ew2QzZ53ytD3VBXn6uvF1yqi lc4yhrYETT3acMIs2I7pg1dQxsPMqbUnz5fvi1/Ge3KJEktxRqKhFnNRcSIAbxkJbu4CAAA=
Archived-At: <https://mailarchive.ietf.org/arch/msg/gen-art/ZUOsBXHJ3KMeU3Lss51UjaeWy0U>
Cc: General Area Review Team <gen-art@ietf.org>
Subject: [Gen-art] Gen-ART Telechat review of draft-ietf-opsawg-capwap-alt-tunnel-08
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: Fri, 21 Oct 2016 15:52:39 -0000

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 wait for direction from your document 
shepherd or AD before posting a new version of the draft. For more 
information, please see the FAQ at 
<​http://wiki.tools.ietf.org/area/gen/trac/wiki/GenArtfaq>.

Document: draft-ietf-opsawg-capwap-alt-tunnel-08
Reviewer: Paul Kyzivat
Review Date: 2016-10-21
IETF LC End Date: 2016-09-30
IESG Telechat date: 2016-10-27

Summary:

(Note: the document is unchanged since last call, so this is a repeat of 
my last-call review.)

This draft is on the right track but has open issues, described in the 
review.

General Impression: I was able to generally understand what this 
document is trying to do, and the details generally seem to be there. 
But I was unable to put all the pieces together to make the entire thing 
work. I think this is due to problems with the organization of the 
document and possibly some missing pieces of information. I feel this 
document needs some reorganization if it is to be understood by somebody 
new to it.

Issues:

Major: 5
Minor: 9
Nits:  0

(NOTE: I had a lot of trouble classifying the level of the issues. I 
finally decided to classify the Major if there is insufficient 
information to do an implementation. But take these classifications with 
a grain of salt.)

(1) MINOR: Normative language:

This document clearly intends to use normative language - there are 
numerous occurrences of "MUST". However I also find a number of uses of 
"shall" (never upper case) that appear to me to be intended as normative 
statements.

(2) MINOR: Figure 4:

This figure shows the WTP having two distinct Alternate Tunnels for 
SSID1. This seems to imply that data traffic to/from SSID1 be classified 
and routed to one or the other of these two tunnels. But I could find no 
discussion of any logic for doing this.

(3) MAJOR: Section 3 (Protocol Considerations):

This section has some organizational problems that make the document 
difficult to. This is hinted at by the very vague title.

It defines three new CAPWAP message Elements, to be included in certain 
CAPWAP messages:

- Supported Alternate Tunnel Encapsulations: is intended for inclusion 
in a CAPWAP Join Request from a WTP to an AC.

- Alternate Tunnel Encapsulations: is intended for inclusion in an IEEE 
802.11 WLAN Configuration Request message from an AC to a WTP.

- IEEE 802.11 WTP Alternate Tunnel Failure Indication: is intended for 
inclusion in a CAPWAP messages from a WTP to an AC. The message type(s) 
that should carry this were unclear to me, though probably evident to 
someone familiar with CAPWAP.

An extensible set of Alternate Tunnel Encapsulation types is defined. 
These are referenced by both Supported Alternate Tunnel Encapsulations 
and Alternate Tunnel Encapsulations.

Each of these requires specification of an Information Element used to 
configure it. The document defines only three of the these. (The 
definition of the others is deferred to future documents.) The 
definitions of these are also direct subsections of section 3, though 
they are a very different sort of thing than the earlier subsections.

Of these three, two are quite simple and understandable. The third (GRE) 
appears to be very complex, with nested sub-elements. I was unable to 
fully decipher this. (More below.)

(4) MINOR: Section 3.2 (Alternate Tunnel Encapsulations Type):

Section 3.1 shows the Tunnel-Type being carried in an 8-bit field, while 
section 3.2 uses a 16-bit field. The actual values are defined in 
section 3.2 and include only values 0-6, with other values reserved for 
future use. The IANA Considerations section defines this as a 16-bit value.

It might be wise to restrict this to 8-bits in the IANA considerations, 
and in section 3.2 reserve the first 8 bits of the type field, as in:

         0                   1                   2                   3
         0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
         +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
         |       0     |  Tunnel-Type  |  Info Element Length            |
         +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
         |   Info Element
         +-+-+-+-+-+-+-+-+-+

While this section defines a new registry of tunnel types, and formats 
for descriptive information element about each, there seem to be no 
rules for defining new values.

Also, I had trouble figuring out which portions of this document are 
defining Information Elements for use in this message, and which are 
defining something else. It would help if the description of each tunnel 
type in the list in this section had a cross reference to the section 
that defines the Information Element for that type. (But a more major 
reorganization would be better.)

(5) MAJOR: Section 3.4 (CAPWAP based Alternate Tunnel):

For the CAPWAP Transport Protocol Element the description mentions two 
possible values (UDP and UDP-Lite), but fails to state what encoding is 
used to designate them.

(6) MAJOR: Section 3.6 (GRE based Alternate Tunnel):

Based on section 3.2, I was expecting the definition of *one* 
information element format for GRE tunnels. But this section says "The 
information element*s* needed for supporting this mode are defined in 
Section 3.7 and Section 3.7.6." and proceeds to define more than one. 
And referencing both 3.7 and 3.7.6 seems at least odd. I suspect the 
reference to 3.7.6 is a mistake because there seems nothing special 
about it.

(7) MAJOR: Section 3.7 (Alternate Tunnel Information Elements):

It appears that sections 3.7.n define sub-elements of an overall GRE 
Information Element, but I find no definition of that overall element.

(8) MINOR: Section 3.7.1 (Access Router Information Elements):

This says: "The AR information may be IPv4 address, IPv6 address, or AR 
domain name." Then it has subsections defining IPv4 and IPv6 addresses. 
But I can find nothing that says how to specify a domain name.

(9) MAJOR: Section 3.7.1.1 (AR IPv4 List Element):

This section seems to call for a constant value designating "AR IPv4 
Element Type" but I find no specification of what that value might be.

(10) MAJOR: Section 3.7.1.2 (AR IPv6 List Element):

This section seems to call for a constant value designating "AR IPv6 
Element Type" but I find no specification of what that value might be.

(11) MAJOR: Section 3.7.2 (IEEE 802.11 WLAN Configuration Response):

I thought this section should be defining part of the Information 
Element for the Alternate Tunnel Encapsulation Type message element from 
the AC to the WTP. Yet this section says that it is intended to be sent 
from the WTP the the AC. This left me scratching my head as to what it 
is and where it goes.

(12) MAJOR: Section 3.7.3 (Tunnel DTLS Policy Element):

I don't understand where this element is intended to be inserted.

The title of this section is "Tunnel DTLS Policy Element", but in figure 
13 the type field is called "Tunnel DTLS Element Type". Why are these 
different? Also, I find no defined numeric value for this field.

(13) MAJOR: Section 3.7.4 (IEEE 802.11 Tagging Mode Policy Element):

This references the 802.11 Tagging Mode Policy in RFC5416. But I was 
unable to decipher how that relates to the Alternate Tunnel 
Encapsulation Type message.

(14) MINOR: Section 4 (IANA Considerations):

This asks IANA to create a new registry of Alternate tunnel types. The 
only values in the registry for each type are the numeric value, a human 
friendly name, and a reference. The references are to the definitions of 
the underlying tunnel protocols.

I understand, this isn't sufficient information to use these values. It 
is also necessary to know the format of the associated Information 
Element for each type. For *some* of the types that information is 
present in this document. For others that information is left for future 
definition, presumably in some new document.

The registry needs to have a reference to a document specifying the 
format of the Information Element for the type.

Also, it would be very helpful if there was a template for how to 
specify the Information Element for a type, and for this document to 
follow that format for the ones it defines.