Re: [netmod] [OPSAWG] Question on draft-ietf-netmod-yang-model-classification

[Juergen Schoenwaelder <[e-mail]>]

I would prefer to have all terms people find agreement on in a single
document.

/js

On Tue, Feb 14, 2017 at 09:54:10AM +0000, Tianran Zhou wrote:
> Hi,
> 
> Based on the discussion, here I try to clean up the confusion of the two I-Ds.
> 
> [draft-ietf-netmod-yang-model-classification] classifies the yang modules into "Network Service YANG Module" and the "Network Element YANG Module". And usually, it uses "service module" to imply the "Network Service YANG Module", i.e., "Network" here only want to limit the scope to network related modules. One example of "Network Service YANG Module" is [draft-ietf-l3sm-l3vpn-service-model].
> The authors do not want to further classify the service module into more layers, until more operational practice comes.
> 
> [draft-wu-opsawg-service-model-explained] further classifies the service module into "customer service module" and the "service delivery module". I think this is based on the chair work on L3SM and L2SM WG and discussion with operators.
> But the document think the "Network Service YANG Module" defined in [draft-ietf-netmod-yang-model-classification] is "service delivery module" not include the "customer service module". The [draft-ietf-l3sm-l3vpn-service-model] is actually the "customer service module".
> 
> Here comes the question:
> 1. Whether it's necessary to further classify the "Network Service YANG Module"?
> 2. What's the well definition of "Network Service YANG Module", "customer service module", "service delivery module"?
> 3. What's the well position of the above terms in the management architecture?
> 
> Good to see if we can solve the conflicts, these two I-Ds can complement each other.
> 
> Best,
> Tianran
> 
> > -----Original Message-----
> > From: netmod [mailto:[e-mail]] On Behalf Of Carl Moberg
> > (camoberg)
> > Sent: Thursday, February 09, 2017 12:48 AM
> > To: [e-mail]
> > Cc: [e-mail];
> > [e-mail]; [e-mail];
> > Dean Bogdanovic
> > Subject: Re: [netmod] Question on
> > draft-ietf-netmod-yang-model-classification
> > 
> > Team,
> > 
> >  Inline below.
> > 
> > > On Feb 8, 2017, at 8:04 AM, Adrian Farrel <[e-mail]> wrote:
> > >
> > > Hi Dean,
> > >
> > > I've been processing your response and the continuing thread with you
> > and Tianran.
> > >
> > >>> We've been trying to ensure that
> > >>> draft-wu-opsawg-service-model-explained is consistent with the
> > >>> latest version of draft-ietf-netmod-yang-model-classification. In
> > >>> discussions with Tianran a question has come up.
> > >>>
> > >>> In section 2 you have a nice definition of Network Service YANG
> > >>> Modules and this definition maps nicely to our definition of "service
> > delivery models".
> > >>> Furthermore, your figure 1 shows Network Service YANG Modules on the
> > >>> interface between OSS/BSS and the various network services.
> > >>>
> > >>> We have further defined "customer service models" at a higher layer
> > >>> still. That is, on the interface to the customer. This (of course?)
> > >>> assumes that the OSS/BSS is not customer code :-)
> > >>>
> > >>> However, your discussion of Network Service YANG Modules in section
> > >>> 2.1 seems slightly at odds, although this may be just ambiguity.
> > >>>
> > >>> For example, when you say, "Network Service YANG Modules describe
> > >>> the characteristics of a service, as agreed upon with consumers of that
> > service,"
> > >>> this is not the same as, "This model is used in the discussion
> > >>> between a customer and a service provide to describe the characteristics
> > of a service."
> > >>> That is, the former case could be arrived at after processing based
> > >>> on the latter case - processing that we have called "service
> > >>> orchestration" but might (of course) be what leads to the operator poking
> > the OSS/BSS.
> > >>
> > >> Adrian, I can see the ambiguity. The point of service module is to be
> > >> consumed by the customer and there can be some modifications of the
> > >> service module to adapt to the customer specifics.
> > >
> > > So far I agree with your email and therefore not with your document. The
> > OSS/BSS is not, IMHO, a tool used by the customer.
> > >
> > > Please see Figure 3 in draft-wu-opsawg-service-model-explained-05.txt
> > that shows the customer distinct from the OSS/BSS.
> > 
> >  IMHO figure 3 in the draft is what it says, an _example_ of a set of
> > relationships between the constituent parts of a provisioning/activation
> > system.
> > 
> >  In all real-world applications, customers are several layers above the
> > “service orchestrator” and adjacent systems. But the YANG model nevertheless
> > serves the purpose of describing the structure of the service for customer
> > (outside the SP) or other consuming parties (e.g. the OSS/BSS teams).
> > 
> > >>> This might all be fine and good, but later in the same section you
> > >>> say "Network Service YANG Modules define service models to be
> > >>> consumed by external systems.
> > >>> These modules are commonly designed, developed and deployed by
> > >>> network infrastructure teams." And there you introduce two terms
> > >>> that are previously undefined and only server to add ambiguity.
> > >>> Specifically "external to what?" I could make and argument that the
> > >>> OSS is developed and deployed by network infrastructure teams, ad also
> > that the OSS is external to the network itself.
> > >>
> > >> Agree that external systems are not defined and this text has to be
> > >> clarified. The external systems can be OSS and BSS.
> > >
> > > If we relabelled our "Service Delivery Model" as "Network Service Model"
> > would that be consistent?
> > >
> > > That is, in any case, to say that the OSS/BSS does not talk directly to
> > the devices.
> > 
> >  I think that would help. And yes, the intent of “external” was to say “other
> > than”, rather than “outside of the company” (or something like that).
> > 
> > >>> And, in between these two quoted pieces of text, you have...
> > >>>
> > >>>  As an example, the Network Service YANG Module defined in
> > >>> [YANG-Data-Model-for-L3VPN-service-delivery] provides an abstract
> > >>> model for Layer 3 IP VPN service configuration.
> > >>
> > >> My question is where do you see the L3SM model above or below OSS?
> > >
> > > Well, look at the figure in section 5 of
> > > draft-ietf-l3sm-l3vpn-service-model-19.txt
> > >
> > > It is logically higher, but OSS/BSS are not "in the flow" as they are
> > legacy components in a softwarized world.
> > > However, per our pictures, OSS/BSS should use the same set of models/modules
> > as used by the "service orchestrator”.
> > 
> >  This is a little different in different SPs. Many of them consider the
> > RFS-style service definition as laid out in L3SM as something that is owned
> > by the infratrstucture and ordered through the OSS/BSS layer (the order
> > manager to be more precise).
> > 
> > >> Because there are some nuances in the service module, but at the end
> > >> we decided not to do sub classification
> > >
> > > Mutter, mutter.
> > > In the document, you talk about "network service modules" not "service
> > modules" and only trim to "service module" in the text implying that you
> > always actually mean "network service module”.
> > 
> >  We always mean “network service models”, there are many “service models”
> > out there that have little or nothing to do with the network. And I would
> > like to not go there :-)
> > 
> > >> one is the business and one technical service.
> > >>
> > >> When i read the YANG-Data-Model-for-L3VPN-service-delivery, it looked
> > >> to me much more like a technical model, then the business model, as
> > >> didn’t see SLA definitions to track the business parameters of the service
> > use.
> > >
> > > It is certainly not a business model and does not include SLAs. Other
> > people have far more experience working on these things (TMF, MEF, ...)
> > and it is not an IETF core competence. Our intention is that our module
> > can be augmented or accompanied by other modules in order to create a business
> > model, acknowledging that commercial details (even including SLAs) will
> > vary from one operator to another, but that the core technical description
> > of the service can be (and, it turns out, is) common across multiple
> > providers.
> > >
> > > We even wrote text in Section 5 of draft-wu-opsawg-service-model-explained
> > to help with this.
> > >
> > >>> Per my other email, this reference needs to be fixed. But I struggle
> > >>> to see the L3SM module as consistent with your figure. It may or may
> > >>> not be consistent with your text dependent on the interpretation.
> > >>
> > >> Sure, we can fix that reference, but the authors of L3SM module
> > >> should do their own module classification, as they are the only ones
> > >> that know the intent of the module.
> > >
> > > That is fine. They can classify it, and they can use your
> > > classification system, but only if it can be understood, is
> > > meaningful, and fits what they are trying to achieve :-)
> > >
> > > Your text currently says
> > >   As an example, the Network Service YANG Module defined in
> > >   [YANG-Data-Model-for-L3VPN-service-delivery] provides an abstract
> > >   model for Layer 3 IP VPN service configuration.
> > >
> > > Your text and figures show "Network Service YANG Module" as being something
> > that the OSS/BSS talks (presumably toward a network orchestrator?). Thus
> > the L3SM module does not fit here. And that is why we wrote
> > draft-wu-opsawg-service-model-explained and included Figure 4 to augment
> > your figure.
> > 
> >  Figure 4 also seems like an _example_ of how one could structure the layers.
> > Personally I have never seen an implementation of a clear split between
> > "Network Service YANG Modules” and "Service YANG Modules”. That’s why we
> > wanted to stay clear of that discussion until there is experience telling
> > us that this is indeed best practice.
> > 
> > > And *finally*, Tianran is concerned that there may be confusion arising
> > from whether the module we reference are "Network service modules", "service
> > delivery modules", "network configuration modules", "network element
> > modules", or "device configuration modules". So many terms, but presumably
> > these modules don't fit into all of the categories! The list is:
> > >
> > > [I-D.dhjain-bess-bgp-l3vpn-yang]
> > 
> > “”"
> >    There are two parts of the BGP L3VPN yang data model.  The first part
> >    of the model defines VRF specific parameters for L3VPN by augmenting
> >    the routing-instance container defined in the routing model [I-
> >    D.ietf-netmod-routing-cfg] and the second part of the model defines
> >    BGP specific parameters for the L3VPN by augmenting the base BGP data
> >    model defined in [I-D.shaikh-idr-bgp-model].
> > “””
> > 
> >  and it’s importing ietf-routing, ietf-interfaces, ietf-interfaces
> > augmenting /rt:routing/ and /if:interfaces/.
> > 
> > From draft-ietf-netmod-yang-model-classification:
> > 
> >  “””
> >    Network Element YANG Modules describe the characteristics of a
> >    network device as defined by the vendor of that device.  The modules
> >    are commonly structured around features of the device, e.g. interface
> >    configuration [RFC7223], OSPF configuration […] “”"
> > 
> >  I would say that [e-mail] is a network element YANG
> > module.
> > 
> > > [I-D.ietf-bess-l2vpn-yang]
> > 
> > “””
> >    In this version of the document, one single container, l2vpn, is
> >    defined.  Within the l2vpn container, endpoint-a, endpoint-z and a
> >    list of endpoints are defined. […]
> > “”"
> > 
> > From draft-ietf-netmod-yang-model-classification:
> > 
> > “””
> >    That is, a
> >    service module does not expose the detailed configuration parameters
> >    of all participating network elements and features, but describes an
> >    abstract model that allows instances of the service to be decomposed
> >    into instance data according to the Network Element YANG Modules of
> >    the participating network elements.
> > “””
> > 
> >  I would say that [e-mail] is a network service YANG
> > module.
> > 
> > > [I-D.ietf-bess-evpn-yang]
> > 
> > 
> >  This draft contains two modules:
> >  - [e-mail]
> >  - [e-mail]
> > 
> >  Reading the first paragraph of section 3.1 “Overview”
> > 
> > “””
> >       Two top level module, Ethernet-Segment and EVPN, are defined. The
> >    Ethernet-Segment contains a list of interface to which any Ethernet-
> >    Segment attributes are configured/applied.
> > “””
> > 
> >  …and understanding that the list of interfaces can be located on different
> > network elements, makes me think that these two modules are both examples
> > of network device YANG modules.
> > 
> > > I wonder what type of module you think these are.
> > >
> > > Cheers,
> > > Adrian
> > >
> > >
> > >
> > 
> > _______________________________________________
> > netmod mailing list
> > [e-mail]
> > https://www.ietf.org/mailman/listinfo/netmod
> _______________________________________________
> OPSAWG mailing list
> [e-mail]
> https://www.ietf.org/mailman/listinfo/opsawg

-- 
Juergen Schoenwaelder           Jacobs University Bremen gGmbH
Phone: [phone]         Campus Ring 1 | 28759 Bremen | Germany
Fax:   [phone]         <http://www.jacobs-university.de/>