Re: [Pce] 'MIB Doctor' review of draft-ietf-pce-pcep-mib-06
"Daniel King" <daniel@olddog.co.uk> Sun, 19 January 2014 21:37 UTC
Return-Path: <daniel@olddog.co.uk>
X-Original-To: pce@ietfa.amsl.com
Delivered-To: pce@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id C801C1ADFA8 for <pce@ietfa.amsl.com>; Sun, 19 Jan 2014 13:37:35 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=ham
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 zMLjnUcYepSq for <pce@ietfa.amsl.com>; Sun, 19 Jan 2014 13:37:33 -0800 (PST)
Received: from asmtp3.iomartmail.com (asmtp3.iomartmail.com [62.128.201.159]) by ietfa.amsl.com (Postfix) with ESMTP id 690731ADFA5 for <pce@ietf.org>; Sun, 19 Jan 2014 13:37:33 -0800 (PST)
Received: from asmtp3.iomartmail.com (localhost.localdomain [127.0.0.1]) by asmtp3.iomartmail.com (8.13.8/8.13.8) with ESMTP id s0JLbIp4018679; Sun, 19 Jan 2014 21:37:19 GMT
Received: from Serenity (88-97-23-122.dsl.zen.co.uk [88.97.23.122]) (authenticated bits=0) by asmtp3.iomartmail.com (8.13.8/8.13.8) with ESMTP id s0JLbHMd018673 (version=TLSv1/SSLv3 cipher=AES128-SHA bits=128 verify=NO); Sun, 19 Jan 2014 21:37:18 GMT
From: Daniel King <daniel@olddog.co.uk>
To: 'Juergen Schoenwaelder' <j.schoenwaelder@jacobs-university.de>
References: <20140119182231.GB42438@elstar.local>
In-Reply-To: <20140119182231.GB42438@elstar.local>
Date: Sun, 19 Jan 2014 21:37:14 -0000
Message-ID: <006501cf155e$9e8a0bf0$db9e23d0$@olddog.co.uk>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Outlook 15.0
Thread-Index: AQFObkfCKJ2AEzeFENJMjL9T3gM/wZuN3+bA
Content-Language: en-gb
Cc: draft-ietf-pce-pcep-mib.all@tools.ietf.org, pce@ietf.org
Subject: Re: [Pce] 'MIB Doctor' review of draft-ietf-pce-pcep-mib-06
X-BeenThere: pce@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: Path Computation Element <pce.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/pce>, <mailto:pce-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/pce/>
List-Post: <mailto:pce@ietf.org>
List-Help: <mailto:pce-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/pce>, <mailto:pce-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 19 Jan 2014 21:37:35 -0000
Thank you for the review Juergen. We will discuss between the authors/vendors and address your comments/recommendations in a new version of the document, and email you directly if we need to clarify any points. Br, Dan. -----Original Message----- From: Juergen Schoenwaelder [mailto:j.schoenwaelder@jacobs-university.de] Sent: 19 January 2014 18:23 To: draft-ietf-pce-pcep-mib.all@tools.ietf.org; pce@ietf.org Cc: mib-doctors@ietf.org Subject: 'MIB Doctor' review of draft-ietf-pce-pcep-mib-06 Hi, please find below my review of draft-ietf-pce-pcep-mib-06. Overall, the document is in a pretty good shape. It is nice to review MIB modules that are well put together. The MIB module compiles fine with smiling 0.4.8 and produces no warnings. Below is a list of comments in document order of appearance. Some may require an action other maybe not. I have marked the ones that I find more important with (*). a) I guess you should spell out PCE In the title. b) The abstract says the I-D defines an "experimental portion" of the MIB while the document is marked as standards-track. This does not seem to be consistent. c) In section 2, ATD should STD. d) The LAST-UPDATED and REVISION clauses as well as the Copyright year in the DESCRIPTION clause of the MODULE-IDENTITY all date back to 2013 even though the I-D was last updated in 2014. You may want to move to a date in 2014. e) I suggest to replace pcePcepMIBObjects with pcePcepObjects. This aligns more with the recommendation given in appendix D of RFC 4181. f) I think the description of pcePcepEntityTable should use plural, that is, "... about PCEP Entities". Or will this table always have only a single row? g) If you want to describe the enums of an INTEGER, please do so in the DESCRIPTION clause and not in comments (since comments may not be preserved by tools processing MIB modules). h) pcePcepEntityAddr seems to serve two purposes, depending on whether the peer is a pce and a pcc. The pcePcepPeerRole object makes me believe an entity can also be both at the same time. If so, then how does one interpret pcePcepEntityAddr? (*) i) pcePcepEntityConnectMaxRetry has a UNITS clause saying it is in seconds. This might be a cut and paste error? j) pcePcepPeerAddr has a length restriction which essentially also restricts pcePcepPeerAddrType. pcePcepPeerAddrType kind of has a restriction inline but not explicit via subtyping. It might be more inline with the INET-ADDRESS-MIB to not restrict this. If you want to restrict things, you may want to do that in a compliance statement. (*) Despite future proofing considerations, the restrictions make it impossible to have PCE entities with non-global that is non-unique addresses (because you may not be able to disambiguate them). k) pcePcepPeerDiscontinuityTime refers to RFC 1907. I think the current version it should refer to is RFC 3418. In any case, if you think explicit text concerning sysUpTime is needed, I think this warrants a normative reference added to RFC 3418 and a statement in section 5.5. (I am not sure this is really needed since you kind of import knowledge about sysUpTime via the TimeStamp TC you are using. j) The *AvgRspTime, *LWMRspTime, *HWMRspTime objects have a resolution of seconds. This means that times < 500ms will be represented as 0 seconds and thus indistinguishable from no message at all. I do not know whether this is an issue or not. Is it possible to have sub-second response times? (*) k) pcePcepSessState typo: entiries -> entries l) pcePcepSessPeerDeadTimer typo: for for -> for -- Juergen Schoenwaelder Jacobs University Bremen gGmbH Phone: +49 421 200 3587 Campus Ring 1, 28759 Bremen, Germany Fax: +49 421 200 3103 <http://www.jacobs-university.de/>
- Re: [Pce] 'MIB Doctor' review of draft-ietf-pce-p… Daniel King
- [Pce] 'MIB Doctor' review of draft-ietf-pce-pcep-… Juergen Schoenwaelder