Re: [netmod] entity naming question

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Fri, 26 August 2016 09:23 UTC

Return-Path: <j.schoenwaelder@jacobs-university.de>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id E928812D11D for <netmod@ietfa.amsl.com>; Fri, 26 Aug 2016 02:23:25 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.748
X-Spam-Level:
X-Spam-Status: No, score=-4.748 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, RP_MATCHES_RCVD=-0.548] 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 jfOjNn1MJBMd for <netmod@ietfa.amsl.com>; Fri, 26 Aug 2016 02:23:24 -0700 (PDT)
Received: from atlas3.jacobs-university.de (atlas3.jacobs-university.de [212.201.44.18]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D9FF412D097 for <netmod@ietf.org>; Fri, 26 Aug 2016 02:23:23 -0700 (PDT)
Received: from localhost (demetrius5.irc-it.jacobs-university.de [10.70.0.222]) by atlas3.jacobs-university.de (Postfix) with ESMTP id 2DD148DF; Fri, 26 Aug 2016 11:23:22 +0200 (CEST)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from atlas3.jacobs-university.de ([10.70.0.205]) by localhost (demetrius5.jacobs-university.de [10.70.0.222]) (amavisd-new, port 10030) with ESMTP id kmGBnxaGk9jE; Fri, 26 Aug 2016 11:23:00 +0200 (CEST)
Received: from hermes.jacobs-university.de (hermes.jacobs-university.de [212.201.44.23]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "hermes.jacobs-university.de", Issuer "Jacobs University CA - G01" (verified OK)) by atlas3.jacobs-university.de (Postfix) with ESMTPS; Fri, 26 Aug 2016 11:23:21 +0200 (CEST)
Received: from localhost (demetrius3.jacobs-university.de [212.201.44.48]) by hermes.jacobs-university.de (Postfix) with ESMTP id 21BBB200AC; Fri, 26 Aug 2016 11:23:21 +0200 (CEST)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius3.jacobs-university.de [212.201.44.32]) (amavisd-new, port 10024) with ESMTP id BKxDMvmYrrkz; Fri, 26 Aug 2016 11:23:20 +0200 (CEST)
Received: from elstar.local (elstar.jacobs.jacobs-university.de [10.50.231.133]) by hermes.jacobs-university.de (Postfix) with ESMTP id E3454200AB; Fri, 26 Aug 2016 11:23:19 +0200 (CEST)
Received: by elstar.local (Postfix, from userid 501) id A97073C4E81B; Fri, 26 Aug 2016 11:23:18 +0200 (CEST)
Date: Fri, 26 Aug 2016 11:23:17 +0200
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Martin Bjorklund <mbj@tail-f.com>
Message-ID: <20160826092315.GA32387@elstar.local>
Mail-Followup-To: Martin Bjorklund <mbj@tail-f.com>, netmod@ietf.org
References: <20160826.105338.1510958649777755391.mbj@tail-f.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <20160826.105338.1510958649777755391.mbj@tail-f.com>
User-Agent: Mutt/1.6.0 (2016-04-01)
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/E5SwShCS8n5v4aqAaE5qs972iLQ>
Cc: netmod@ietf.org
Subject: Re: [netmod] entity naming question
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 26 Aug 2016 09:23:26 -0000

On Fri, Aug 26, 2016 at 10:53:38AM +0200, Martin Bjorklund wrote:
> Hi,
> 
> It seems that some people prefer the term 'hardware' instead of
> 'entity' for things that are ... hardware.
> 
> Should we make this change in the document?  Specifically, the
> top-level node 'entity' would then be renamed to 'hardware'.  Probably
> other changes as well, but we can start with this one.

Well, 'hardware' would equate 'physical entity' but not 'entity'. ;-)

I agree that the ENTITY-MIB terminology is generally confusing (except
for those who got used to it). Changing the nomenclature will be a
bigger thing that just renaming the top-level, the 'physical-entity'
would likely become a 'component', e.g.

module: ietf-hardware
   +--ro hardware-state
   |  +--ro last-change?       yang:date-and-time
   |  +--ro component* [name]
   |     +--ro name                  string
   |     +--ro class?                identityref
   :
   :
   +--rw hardware
      +--rw component* [name]
         +--rw name                  string
         :

and there are more 'entity' words to replace (feature names plus many
edits in the texts). I believe it is worth to move to a terminology
that is far easier to understand and use; as long as the relationship
to the old MIB modules is clearly documented we are fine I think.

/js

PS: We had a discussion in a separate thread whether base identities
    of identities defined in IANA module should not be defined in the
    IANA modules themself; this allows reuse by just importing the
    IANA module. Perhaps this applies here as well.
    

-- 
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/>