Re: [MIB-DOCTORS] MIB Dr. review of draft-ietf-mpls-mldp-mib-01

"Joan Cucchiara" <jcucchiara@mindspring.com> Tue, 21 March 2017 17:19 UTC

Return-Path: <jcucchiara@mindspring.com>
X-Original-To: mib-doctors@ietfa.amsl.com
Delivered-To: mib-doctors@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9360C1289C3; Tue, 21 Mar 2017 10:19:29 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.719
X-Spam-Level:
X-Spam-Status: No, score=-2.719 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=mindspring.com; domainkeys=pass (2048-bit key) header.from=jcucchiara@mindspring.com header.d=mindspring.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 PX07KS5X0rON; Tue, 21 Mar 2017 10:19:26 -0700 (PDT)
Received: from elasmtp-mealy.atl.sa.earthlink.net (elasmtp-mealy.atl.sa.earthlink.net [209.86.89.69]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 0B4FD1287A7; Tue, 21 Mar 2017 10:19:26 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mindspring.com; s=dk12062016; t=1490116766; bh=01WkZTd8zTDHE33T16VeHT1VzRE+866uUf0f CD5dGXM=; h=Received:From:To:Cc:References:In-Reply-To:Subject:Date: Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding: X-Mailer:Thread-Index:Content-Language:X-ELNK-Trace: X-Originating-IP; b=dgzzutGrWCliKUmLBtwMHylJzwp1mURR02pyHhQ855Njp3 PbmEpj1kcKoVp5YMGiJx5VykOdG6B/IB7AOSuxkwCtVHbCZfWTCgjyvY9eKUOPJjYUd cSD60FrFYWGNgMHnU6u9DRK6DdWnwFfELUSkd2ChTifwXP1zmTS8hocWmcYHYiqAi7Z 3MLNEiQH8GEqAHnzp+00a87yELJpepyVx5l562yAcuUfflDUFlUtnFqUy+W0OB6HlZh OB22AXWLS/NY3Ip2W2yZP0QXXniMApJiOzg744bd/DrWV97z7hkWsjw+Z30LOQGDFP6 8fX0NUIa9aVth/hA5mkatDkwCakQ==
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=dk12062016; d=mindspring.com; b=NynIOgLfPinHolYwV6omBm3A9qUWzvdj3s84o7mgG78nS13dbSOWj/U9q0If3sKoNLs+9z5x5jT+0DcLT7iyIrk6Rrs27L7alsgyyEO0N0cQblKRlzwT01SUE2EopJwLqz3z/5+/I1j20vu6cPvZmDSpMXuXv8msiP2UKarKec334u8qOSUDQgSj0NtnWASnMfILRPrJQX5z4LGZML0DXsn+NbSFeq2mu8vn3/myWaBl5qeQhwdmOP+Czf5lFcqfigPpP6OrQm6CdCfLhtHrf+UNBXp+5AvI34eTDJBk+GIeR6w5U/u1RhPko0tVP2hjzUeFr61rYQ6Hrvd8399mEw==; h=Received:From:To:Cc:References:In-Reply-To:Subject:Date:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding:X-Mailer:Thread-Index:Content-Language:X-ELNK-Trace:X-Originating-IP;
Received: from [72.93.241.40] (helo=JoanTower) by elasmtp-mealy.atl.sa.earthlink.net with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.67) (envelope-from <jcucchiara@mindspring.com>) id 1cqNQx-0004N2-P3; Tue, 21 Mar 2017 13:18:59 -0400
From: Joan Cucchiara <jcucchiara@mindspring.com>
To: 'Kishore Tiruveedhula' <kishoret@juniper.net>, 'Loa Andersson' <loa@pi.nu>, jcucchiara.ietf@gmail.com, mib-doctors@ietf.org
Cc: draft-ietf-mpls-mldp-mib@ietf.org
References: <CANSkkOk1bztCQMiDjfDLO7_+x0pxBeKiBEZMZVEru0CeEkmztw@mail.gmail.com> <20332454-6349-1217-4807-c4d47e2043df@pi.nu> <317118C9-5CDE-4D5A-84D3-B6C6CF546E78@juniper.net> <D4F6BE43.7C6EA%kishoret@juniper.net>
In-Reply-To: <D4F6BE43.7C6EA%kishoret@juniper.net>
Date: Tue, 21 Mar 2017 13:18:58 -0400
Message-ID: <01f601d2a267$3a935130$afb9f390$@mindspring.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
X-Mailer: Microsoft Outlook 14.0
Thread-Index: AQK530ZPgs88a33KtYfCF920WHSrzADBe6ULAqojbF4CUDMEXp+jMIqQ
Content-Language: en-us
X-ELNK-Trace: 4d68bbe9cb71969ea344cf2d1a8e60840a9da525759e2654e55aca647b43fc5d3c10400f4dde6bc7ac30c6e5e32ee181350badd9bab72f9c350badd9bab72f9c
X-Originating-IP: 72.93.241.40
Archived-At: <https://mailarchive.ietf.org/arch/msg/mib-doctors/Z47PLwjKYE4sUrbMKr7Dff7AtVw>
Subject: Re: [MIB-DOCTORS] MIB Dr. review of draft-ietf-mpls-mldp-mib-01
X-BeenThere: mib-doctors@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: MIB Doctors list <mib-doctors.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/mib-doctors>, <mailto:mib-doctors-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/mib-doctors/>
List-Post: <mailto:mib-doctors@ietf.org>
List-Help: <mailto:mib-doctors-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/mib-doctors>, <mailto:mib-doctors-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 21 Mar 2017 17:19:30 -0000

HI Kishore,

Yes, please change to NOT use hyphens.    Could you update doc and send me a
version of the draft when the MIB compiles cleanly?

Thanks,
-Joan


> -----Original Message-----
> From: MIB-DOCTORS [mailto:mib-doctors-bounces@ietf.org] On Behalf Of
> Kishore Tiruveedhula
> Sent: Tuesday, March 21, 2017 1:03 PM
> To: Loa Andersson; jcucchiara.ietf@gmail.com; mib-doctors@ietf.org
> Cc: draft-ietf-mpls-mldp-mib@ietf.org
> Subject: Re: [MIB-DOCTORS] MIB Dr. review of draft-ietf-mpls-mldp-mib-01
> 
> Hi Joan,
> 
>   Thanks for the review.
> 
> I addressed your comments and attached new draft. I will post it later as
cut
> off date passed for IETF98.
> I will double check with the MIB compiler before posting the draft. Please
let
> me know if any comments in the attached new draft.
> 
> One question about hyphen. With the hyphen, it is giving below warning.
> Without hyphen should I changed to single word like
> ³upstreamLabelAssignment" ?
> 
> ----------------
> ibs/MPLS-MLDP-STD-MIB:279: [4] {hyphen-in-label} warning: named bit
> `upstream-label-assignment' must not include a hyphen in SMIv2
> mibs/MPLS-MLDP-STD-MIB:283: [4] {hyphen-in-label} warning: named bit
> `prot-lsr' must not include a hyphen in SMIv2
> mibs/MPLS-MLDP-STD-MIB:286: [4] {hyphen-in-label} warning: named bit
> `node-prot' must not include a hyphen in SMIv2
> --------------
> 
> 
> 
> Thanks,
> Kishore
> 
> 
> On 3/21/17, 7:38 AM, "Kishore Tiruveedhula" <kishoret@juniper.net> wrote:
> 
> >Hi Loa,
> >    I missed Joan's below email.
> >I will address all the comments today.
> >
> >Thanks,
> >Kishore
> >
> >Sent from my iPhone
> >
> >> On Mar 21, 2017, at 6:55 AM, Loa Andersson <loa@pi.nu> wrote:
> >>
> >> Authors,
> >>
> >> This draft is expiring, I also have the comments below from Joan.
> >>When do you think this will  be fixed?
> >>
> >> /Loa
> >>
> >>> On 2017-02-11 10:20, Joan Cucchiara wrote:
> >>> Hello Authors,
> >>>
> >>> This draft has come a long way since the previous version.  Thanks
> >>>for that.
> >>>
> >>> Please make sure the MIB compiles with smilint prior to MIB review
> >>>as it  is difficult to review a  MIB Module that doesn't compile.
> >>>
> >>> Also, please add compliance statements and conformance groups.
> >>>
> >>> Comments below.
> >>> Thanks,
> >>> -Joan
> >>>
> >>>
> >>> output from smilint compiler:
> >>> ------------------------------
> >>> While processing your request the following errors and/or warnings
> >>> have been found:
> >>>
> >>> mibs/MPLS-MLDP-STD-MIB:76: [5] {date-year-2digits} warning: date
> >>>specification `2016092600Z' contains a two-digit year representing
> >>>`1920'
> >>> mibs/MPLS-MLDP-STD-MIB:76: [2] {date-month} date specification
> >>>`2016092600Z' contains an illegal month
> >>> mibs/MPLS-MLDP-STD-MIB:76: [2] {date-hour} date specification
> >>>`2016092600Z' contains an illegal hour
> >>> mibs/MPLS-MLDP-STD-MIB:76: [4] {date-in-past} warning: date
> >>>specification `2016092600Z' predates the SMI standard
> >>>
> >>> Then after that was fixed, more errors:
> >>>
> >>> mibs/MPLS-MLDP-STD-MIB:268: [2] {identifier-redefined} redefinition
> >>> of identifier `mplsLdpPeerCapabilityEntry'
> >>> mibs/MPLS-MLDP-STD-MIB:254: [6] {previous-definition} info: previous
> >>> definition of `mplsLdpPeerCapabilityEntry'
> >>> mibs/MPLS-MLDP-STD-MIB:268: [1] {internal-other} syntax error,
> >>> unexpected COLON_COLON_EQUAL, expecting OBJECT
> >>> mibs/MPLS-MLDP-STD-MIB:271: [5] {internal-flushing} warning:
> >>> flushing recent incorrect declaration, see previous error(s)
> >>> mibs/MPLS-MLDP-STD-MIB:279: [4] {hyphen-in-label} warning: named
> bit
> >>> `upstream-label-assignment' must not include a hyphen in SMIv2
> >>> mibs/MPLS-MLDP-STD-MIB:283: [4] {hyphen-in-label} warning: named
> bit
> >>> `prot-lsr' must not include a hyphen in SMIv2
> >>> mibs/MPLS-MLDP-STD-MIB:286: [4] {hyphen-in-label} warning: named
> bit
> >>> `node-prot' must not include a hyphen in SMIv2
> >>> mibs/MPLS-MLDP-STD-MIB:386: [1] {internal-other} syntax error,
> >>> unexpected UPPERCASE_IDENTIFIER, expecting COLON_COLON_EQUAL
> >>> mibs/MPLS-MLDP-STD-MIB:417: [5] {internal-flushing} warning:
> >>> flushing recent incorrect declaration, see previous error(s)
> >>> mibs/MPLS-MLDP-STD-MIB:482: [2] {description-missing} description
> >>> missing in object definition
> >>> mibs/MPLS-MLDP-STD-MIB:482: [1] {internal-other} syntax error,
> >>> unexpected MAX_ACCESS, expecting COLON_COLON_EQUAL
> >>> mibs/MPLS-MLDP-STD-MIB:493: [5] {internal-flushing} warning:
> >>> flushing recent incorrect declaration, see previous error(s)
> >>> mibs/MPLS-MLDP-STD-MIB:1060: [1] {internal-other} syntax error,
> >>> unexpected '}', expecting UPPERCASE_IDENTIFIER or
> >>> LOWERCASE_IDENTIFIER or NUMBER
> >>> mibs/MPLS-MLDP-STD-MIB:1060: [5] {internal-flushing} warning:
> >>> flushing recent incorrect declaration, see previous error(s)
> >>> mibs/MPLS-MLDP-STD-MIB:1061: [1] {internal-other} syntax error,
> >>> unexpected STATUS
> >>>
> >>>
> >>>
> >>> General Comments (please check throughout document)
> >>>
> >>>---------------------------------------------------------------------
> >>>---
> >>>---------
> >>> *) Need to get this to compile using smilint.
> >>>
> >>>
> >>> *) When other documents (RFCs or drafts) are mentioned, there should
> >>> be a reference notation given.  Please fix this throughout the draft.
> 
> [Kishore] Fixed.
> 
> >>>
> >>> *) Naming Conventions:  Please refer to RFC4181 (MIB guidelines).
> >>> Basically, the naming conventions used in this MIB Module do not
> >>> follow the recommended naming conventions (Appendix C).
> >>>
> >>> Prefix should be used throughout for all objects/tables/entries etc.
> >>> So "mplsMldp" needs to be used consistently.
> 
> [Kishore] All objects have mplsMldp. The only table
> mplsLdpPeerCapabilityTable is not defined in the LDP MIB. I added in the
> mLDP MIB.
> 
> 
> 
> >>>
> >>>
> >>> *) Think there are more AUGMENTS relationships between RFC3815
> >>> Tables and Tables in this MIB Module but they are not defined as
> >>> AUGMENTS within the MIB Module but are described as such within the
> >>> document sections.   Please make sure that the relationships between
> >>> these tables are clarified.
> >>> e.g.  mplsMldpPeerCapabilityTable and mplsLdpPeerTable
> >>>
> >>>
> >>> Section 2.
> 
> [Kishore] Ok. I will more text to clarify this. As the
> mplsLdpPeerCapabilityTable is not defined the STD-LDP-MIB, this table is
> defined in MLDP MIB.
> 
> 
> >>>
> >>> Remove the first paragraph.  Think this is understood.
> >>>
> >>>   [[CREF1: The title and text for this section has been copied from
the
> >>>   official boilerplate, and should not be modified unless the official
> >>>   boilerplate text from the OPS Area web site has changed.  See
RFC4818
> >>>   section 3.1 for a discussion of the boilerplate section.]]
> 
> [Kishore] Removed this section.
> 
> >>>
> >>>
> >>> Section 4. Overview
> >>>
> >>> *) Make sure the RFCs/drafts listed are referenced as being in the
> >>>References Section (probably the Normative References section).  Some
> >>>of  them are, some of the are not.  Be consistent.
> 
> 
> >>>
> >>> *) Not very helpful to list a bunch of documents and not specify which
> >>> features (i.e. specify the sections/sub-sections) appear in which
> >>> documents.
> >>> We already can see the list of documents in the References section so
> >>> unless features/sections/subsections from these docs are specified per
> >>> document, then don't see this as adding information.
> 
> [Kishore] Fixed.
> 
> >>>
> >>> *) Also, some out of date listings, so need to update these.
> >>> ietf-rtgwg-mofrr is an RFC as of 8/2015
> 
> [Kishore] Changed to RFC7431.
> 
> 
> >>> ietf-mpls-mldp-node-protection is an RFC as of 1/2016
> 
> [Kishore]  Changed to RFC 7715.
> 
> >>>
> >>> *) typo:  ...stats per per Interface
> 
> [Kishore] Fixed.
> 
> >>>
> >>>
> >>> Section 6.2
> >>>
> >>>   mplsMldpSessionStatsTable : This table contains the number of mLDP
> >>>   FECs received and advertised to particular LDP session.
> >>>
> >>> s/to particular LDP session/ to a particular LDP session/
> 
> [Kishore] Fixed.
> 
> >>>
> >>>
> >>> Section 7.
> >>>
> >>>   There are ten scalars, listed below are defined for this MIB module.
> >>>
> >>> *) above sentence is awkward.  Maybe something like:
> >>>
> >>> The following scalars are defined in this MIB Module:
> 
> [Kishore] Fixed.
> 
> 
> >>>
> >>>
> >>> Section 8.1
> >>>
> >>> *) s/from LDP peer/from an LDP peer/
> 
> [Kishore] Fixed.
> 
> >>>
> >>>
> >>> Section 8.5
> >>>
> >>> typo in section's title
> >>> s/Upstreaam/Upstream/
> 
> [Kishore] Done.
> 
> >>>
> >>>
> >>> Section 8.6
> >>>
> >>> s/gives the information/gives information/
> 
> [Kishore] Done.
> 
> >>> s/about number/about the number of/  (2 occurrences)
> 
> [Kishore] Done.
> 
> >>>
> >>> s/received on particualr/received on a particular/
> 
> [Kishore] Done.
> 
> >>>
> >>> Please note:  will review the other sections once the MIB compiles and
> >>> compliance statements are added.
> 
> [Kishore] Ok.
> 
> >>>
> >>>
> >>> References Section:
> >>> *) Some references (drafts) out of date and RFCs are out of order
> >>> References.  Please update.
> 
> 
> >>>
> >>> Other
> >>> *) Please remove Appendix A and Appendix B (and regenerate the Table
> of
> >>> Contents.)
> 
> [Kishore] Done.
> 
> >>>
> >>>
> >>
> >> --
> >>
> >>
> >> Loa Andersson                        email: loa@mail01.huawei.com
> >> Senior MPLS Expert                          loa@pi.nu
> >> Huawei Technologies (consultant)     phone: +46 739 81 21 64