Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Expand
titleTable of Contents

Table of Contents


Model Overview

Image Modified


BBS use case aims at using ONAP for the design, creation and activation of the High Speed Internet Access CFS.

Model Design

Gliffy
size1200
nameBBS - ModelOverview
pagePin14
Image Removed
16

Representation in SDC

Image Added

Resource Representations

Modeled ResourceSDC RepresentationA&AI objectTOSCA file
ONT NNIConnection PointcpontNni.yaml & ontNni.json (for import)

PON UNI

Connection Pointcp

ponUni.yaml & ponUni.json (for import)

OLT NNIConnection Point

cp

oltNni.yaml & oltNni.json (for import)
BNG UNIN/AcpODN ConnectionVNF Virtual Linkl3-network ??Transport ConnectionN/Al3-network ??
Access ConnectivityVirtual Function Componentgeneric-vnfaccessConnectivity.yaml
Internet ProfileVirtual Function Componentgeneric-vnfinternetProfile.yaml

BNG

N/AvnfcCPE (PNF)PNFVirtual Function ComponentpnfcpePnf.yaml

Composition of services

Edge RFSCPE PNFNNI
Access Connectivity VFCNNI
ServiceComposed Of
HSIA N/A
HSIA Internet Internet Profile VFC
HSIA AccessCFS (BBS E2E Service)

CPE VF*
- CPE VFC

ONT-

NNI CP

ODN Connection Vnf Virtual Link

PON-UNI CP

Access Connectivity VF
- Access Connectivity VFC

OLT-

NNI CP

HSIA CFS

 HSIA Internet Service

HSIA Access Service

(with a SDC workaround to allow nested services)

Open Issues

  1. We cannot have one VNF composed of a PNF. So the HSIA Access must be a service and not a VNF. Victor will explain how we can nest one service inside other in SDC by utilizing a known workaround.
  2. We need to discuss if the l3-network A&AI object is the proper way of representing SDC Virtual links (ODN Connection/Transport Connection) for our use case.
  3. We need to clarify the steps on how to find the proper Transport Connection to connect the OLT-NNI Connection Point to. Not clear.

Representation in A&AI

Image Removed

Model Parameter Life-cycle

Table on information model 'storage' and


Internet Profile VF
- Internet Profile VFC


(*) with workaround to model PNF in SDC

Representation in A&AI

Gliffy
nameBBS in AAI
pagePin3

Expand
titleRepresentation in AAI for next releases R4+

Image Added


Model Parameter Life-cycle

Table on information model 'storage' and discovery-inventory analysis for BBS use case parameters

BBS Parameter Table

        Input (Just added after Edge/
ONAP AwarenessSDNC (Access Discovery)SDN-C (Edge Discovery)SDC (Service Creation from Portal)DCAE Registration PNFSDN-C (Access Service)

DCAE

CPE Auth

A&AI
 Service (HSIA)
 RG MAC Add 

Input


Input 
 Service Type

Input   Input 
 Service Type  Input   Input 



 Upstream Speed  Input    Input 
 Upstream Speed

Input 


 Input 
 Downstream Speed  

Input   


 Input 
 Access  Remote ID  

Input (Optional)  Input 
Input (used to find the CFS associated with PNF) Input
 Orch Status   



Derived - Obtained from CFS associated with PNF in PNF RegistrationDerived - Obtained from CFS associated w PNF and MAC Address Input
 HSIA Access    
 CPE/ONT PNF      
 PNF Name  

Input (CorrelationID) SourceName
 SourceName Input
 MAC Address   


Input
Input Input
 Manufacturer  

 Onboarded  Onboarded CSAR ArtifactInput 

 Input
 Serial Number  


 Input

 

  

 Input
 Model   


 Input  

 Input
 Type  

 Onboarded CSAR Artifact Input 

 Input
 SW Version   


 Input (Optional)
   Input (Optional) Input
Attachment Point (new field)


Input

Input
CPE Authentication State




Input (Used to derive the CFS orchestration status)
ONT NNI (PORT) (Future?) 



    Input from response when access connectivity is created 
 Input
 ODN Virtual Link (future- reuse SDC VL?)    Link 



Input from response when access connectivity is created
 Input
Access Connectivity
Service Type



Input (from CFS)

Upstream Speed



Input (from CFS)

Downstream Speed



Input (from CFS)

 PON UNI
 CVLAN  

 Input (Optional) Input Input when access connectivity is created or CFS if not in DCAE Reg
 Input
Expected ONT ID  

 Input (Optional) 
 Input (from CFS) 
 Input

OLT Name

Input

 Derived (Attachment Point)

Input
OLT PON SlotInput

 Derived (Attachment Point)

Input
OLT PON PortInput

 Derived (Attachment Point)

Input
OLT NNI
SVLANInput
Input (Optional)Input Input when access connectivity is created or CFS if not in DCAE Reg
Input
OLT NameInput




Input
OLT NNI SlotInput




Input
OLT NNI PortInput




Input
HSIA Edge
Transport ConnectionInput


Expand
titleBBS Parameter Table for next releases R4+

BBS Parameter Table

Code Block
languageyml
firstline1
titleTOSCA model for HSIA Edge RFS
linenumberstrue
collapsetrue
Info

HSIA Access RFS Proposal from Victor.

  • Pnf derived from existing pnf node type in SDC: org.openecomp.resource.abstract.nodes.PNF
  • UNI/NNI derived from tosca.nodes.nfv.vduCp
  • Connectivity will reuse tosca.nodes.nfv.vduVirtualLink
    ONAP AwarenessSDNC (Access Discovery)
    BNG UNIInput

    Input

    TOSCA Models

    Code Block
    languageyml
    firstline1
    titleTOSCA model for HSIA Access RFS
    linenumberstrue
    collapsetrue
    tosca_definitions_version: tosca_simple_yaml_1_0
    description: Template for HSIA Access RFS
    
    capability_types:
      org.onap.bbs.capabilities.ONTCapability:
        derived_from: onap.capabilities.PNFDevice
        description: Declaration of being an ONT PNF Device
    
    node_types:
    
      # New ONT PNF Node Types
      org.onap.bbs.OntDeviceNode:
        derived_from: onap.nodes.PNFDevice
        description: A PNF ONT device
     
      org.onap.bbs.OntNode:
        derived_from: onap.nodes.Function
        description: An ONT Resource
        properties:
          OntID:
            type: string
            description: ID of ONT
          rgMacAddress:
            type: string
            description: RG MAC address for which Internet is offered
     	  OntType:
            type: string
            description: Type of ONT
            required: false
          OntSwVersion:
            type: string
            description: Software version of ONT
            required: false
    
      # New Type for HSIA Access Fevice
      org.onap.bbs.AccessConnectivityNode:
        derived_from: onap.nodes.Function
        metadata:
          type: VNF
        properties:
     	  serviceType:
            type: string
            description: Type of HSIA service offered to customer
          upstreamSpeed:
            type: integer
            description: Speed for upstream traffic
          downstreamSpeed:
            type: integer
            description: Speed for downstream traffic
        capabilities:
          PON_UNI_Binding:
            type: onap.capabilities.Bindable
          OLT_NNI_Binding:
            type: onap.capabilities.Bindable 
    
      # New Types for HSIA Acces Connection Points
      org.onap.bbs.PonUniConnectionPoint:
        derived_from: onap.nodes.CP
        properties:
          CVLAN:
            type: string
            description: CVLAN of customer of HSIA service
            required: false
          ExpectedOntID:
            type: string
            description: Expected ONT ID (in case of pre-provisioned ONTs)
            required: false
        attributes:
          oltName:
            type: string 
            description: Name of OLT hosting this CP
          oltPonSlot:
            type: integer
            description: OLT PON Slot number hosting this CP
          oltPonPort:
            type: integer
            description: OLT PON Port number hosting this CP
    
      org.onap.bbs.OltNniConnectionPoint:
        derived_from: onap.nodes.CP
        properties:
          SVLAN:
            type: string
            description: SVLAN of HSIA service
            required: false
        attributes:
          oltName:
            type: string 
            description: Name of OLT hosting this CP
          oltNniSlot:
            type: integer
            description: OLT NNI Slot number hosting this CP
          oltNniPort:
            type: integer
            description: OLT NNI Port number hosting this CP
    
      org.onap.bbs.OntNniConnectionPoint:
        derived_from: onap.nodes.CP
        attributes:
          ontNniPort:
            type: integer
            description: ONT NNI Port number hosting this CP 
    
      # New Type for HSIA Internet Profile
      org.onap.bbs.InternetProfileNode:
        derived_from: onap.nodes.Function
        metadata:
          type: VNF
        properties:
          rgMacAddress:
            type: string
            description: RG MAC address for which Internet is offered
          serviceType:
            type: string
            description: Type of HSIA service offered to customer
          upstreamSpeed:
            type: integer
            description: Speed for upstream traffic
          downstreamSpeed:
            type: integer
            description: Speed for downstream traffic
        attributes:
          accessID:
            type: string
            description: Access ID assigned for this internet service
    
    ############################
    # HSIA Access RFS Topology #
    ############################
    topology_template:
    
      node_templates:
     
      # ONT
      OntPhysical:
        type: org.onap.bbs.OntDeviceNode
        capabilities:
          pnf_device:
            type: org.onap.bbs.capabilities.ONTCapability
    
      OntPNF:
        type: org.onap.bbs.OntNode
        capabilities:
          bindOntNNI:
            type: onap.capabilities.Bindable
        requirements:
          - pnf_device:
              node: OntPhysical
              capability: org.onap.bbs.capabilities.ONTCapability 
     
      # ONT Connection Point
      OntNNI:
        type: org.onap.bbs.OntNniConnectionPoint
        requirements:
          - OntBinding:
              node: OntPNF
              capability: onap.capabilities.Bindable
          - ODNConnectionLinking:
              node: ODNConnection
              capability: onap.capabilities.Linkable
    
      # ODN Connection between ONT PNF and Access Device VNF
      ODNConnection:
        type: onap.nodes.VL
        capabilities:
          link:
            type: onap.capabilities.Linkable
    
      # Access Device VNF
      AccessConnectivity:
        type: org.onap.bbs.AccessConnectivityNode
        capabilities:
          bindPonUNI:
            type: onap.capabilities.Bindable
          bindOltNNI:
            type: onap.capabilities.Bindable 
    
      # Access Device Connection Points
      PonUNI:
        type: org.onap.bbs.PonUniConnectionPoint
        requirements:
          - accessDeviceBinding:
              node: AccessDevice
              capability: bindPonUNI
          - ODNConnectionLinking:
              node: ODNConnection
              capability: onap.capabilities.Linkable
    
      OltNNI:
        type: org.onap.bbs.OltNniConnectionPoint
        requirements:
          - accessDeviceBinding:
              node: AccessDevice
              capability: bindOltNNI
          # "TransportConnectionLinking" stays unsatisfied, providing only filtering info 
          # of a VL with a property of "type=tranportLink"
          # Orchestrator must satisfy it
          - TransportConnectionLinking:
              node_filter:
                capabilities: onap.nodes.VL
                properties:
                  type: tranportLink
     
      # Internet Profile VNF
      InternetProfile:
        type: org.onap.bbs.InternetProfileNode
    
    SDN-C (Edge Discovery)SDC (Service Creation from Portal)DCAE Registration PNFSDN-C (Access Service)

    DCAE

    CPE Auth

    A&AI
     Service (HSIA)
     RG MAC Add

    Input


    Input 
     Service Type

    Input


    Input 
     Upstream Speed

    Input 


     Input 
     Downstream Speed

    Input


     Input 
     Remote ID

    Input (Optional)  Input
    Input (used to find the CFS associated with PNF) Input
     Orch Status



    Derived - Obtained from CFS associated with PNF in PNF RegistrationDerived - Obtained from CFS associated w PNF and MAC Address Input
     HSIA Access    
     CPE/ONT PNF      
     PNF Name

    Input (CorrelationID) SourceName
     SourceName Input
     MAC Address


    Input
    Input Input
     Manufacturer

     Onboarded CSAR ArtifactInput 

     Input
     Serial Number


     Input

      

     Input
     Model


     Input

     Input
     Type

     Onboarded CSAR Artifact Input

     Input
     SW Version


     Input (Optional)
      Input (Optional) Input
    Attachment Point (new field)


    Input

    Input
    CPE Authentication State




    Input (Used to derive the CFS orchestration status)
    ONT NNI (PORT)



      Input from response when access connectivity is created
     Input
     ODN Virtual Link 



    Input from response when access connectivity is created
     Input
    Access Connectivity
    Service Type



    Input (from CFS)

    Upstream Speed



    Input (from CFS)

    Downstream Speed



    Input (from CFS)

     PON UNI
     CVLAN

     Input (Optional) Input Input when access connectivity is created or CFS if not in DCAE Reg
     Input
    Expected ONT ID

     Input (Optional)
     Input (from CFS)
     Input

    OLT Name

    Input

     Derived (Attachment Point)

    Input
    OLT PON SlotInput

     Derived (Attachment Point)

    Input
    OLT PON PortInput

     Derived (Attachment Point)

    Input
    OLT NNI
    SVLANInput
    Input (Optional)Input Input when access connectivity is created or CFS if not in DCAE Reg
    Input
    OLT NameInput




    Input
    OLT NNI SlotInput




    Input
    OLT NNI PortInput




    Input
    HSIA Edge
    Transport Connection
    Input



    Input (Just added after Edge/ Access Discovery)
    BNG UNI
    Input



    Input


    Service-instance-related information

    See AAI-BBS Proposals for Dublin Release#BBSProposalsforDublinRelease-Item6.Specificdecisionsmadeforeachattribute 


    BBS Properties Per HSIA CFS Service Instance
    Input Source
    ONAP Components that must fetch the value from A&AIDoes it really need A&AI storage?

    A&AI Metaname 

    (for Metadata)

    RG MAC Address

    Service Order via Ext API

    It also comes in the CPE Authentication Event

    bbs-event-processor
    DCAE microservice
    (it fetches existing value from A&AI to compare it with the new value coming from PNF CPE authentication event in order to deduce if there is any mismatch)
    Yes, as metadata of CFS service instancergw-mac-address
    Correlation ID (PNF-name)

    Service Order via Ext API

    It also comes in the sourceName of the PNF registration event's commonEventHeader


    Yes, as property of PNF object
    Service TypeService Order via Ext API

    SO / bbs-apex-policy

    (during Access Connectivity and Internet Profile VFCs creation & update)

    Yes, as metadata of CFS service instanceservice-type
    Access IDPNF registration event

    SDN-C or SO? / bbs-apex-policy

    (during Internet Profile VFC creation & update)

    Yes, as metadata of CFS service instanceremote-id
    Upstream SpeedService Order via Ext API

    SDN-C or SO? / bbs-apex-policy

    (during Internet Profile VFC creation & update)

    Yes, as metadata of CFS service instanceup-speed
    Downstream SpeedService Order via Ext API

    SDN-C or SO? / bbs-apex-policy

    (during Internet Profile VFC creation & update)

    Yes, as metadata of CFS service instancedown-speed

    OLT Name

    PNF registration event
    (extracted from attachment point)



    OLT PON portPNF registration event
    (extracted from attachment point)



    OLT PON slotPNF registration event
    (extracted from attachment point)



    CVLAN

    PNF registration event

    Service Order via Ext API [optional - if not provided by Access SDN M&C]

    SDN-C or SO? / bbs-apex-policy

    (during Internet Profile VFC creation & update)

    Yes, as metadata of CFS service instancecvlan
    SVLAN

    PNF registration event

    Service Order via Ext API [optional - if not provided by Access SDN M&C]

    SDN-C or SO? / bbs-apex-policy

    (during Internet Profile VFC creation & update)

    Yes, as metadata of CFS service instancesvlan
    Expected ONT IDService Order via Ext API [optional]

    SDN-C or SO?

    (for Access Connectivity VFC creation)

    Yes, as metadata of CFS service instanceexpected-ont-id
    CPE ManufacturerPNF registration event
    Yes, as property of PNF objectNot Applicable
    CPE ModelPNF registration event
    Yes, as property of PNF objectNot Applicable
    CPE Equipment TypePNF registration event
    Yes, as property of PNF objectNot Applicable
    CPE Serial NumberPNF registration event
    Yes, as property of PNF objectNot Applicable
    CPE SW Version

    PNF registration event 

    (also present in CPE Authentication Event)


    Yes, as property of PNF objectNot Applicable

    Attachment Point

    (Not a real BBS modeling property, since its constituent parts are captured in other model properties)

    PNF registration event
    bbs-event-processor
    DCAE microservice
    (it fetches existing value from A&AI to compare it with the new value coming from PNF re-registration event in order to deduce if it is a true relocation)
    Yes, as value of link-name property of a logical-link bridged to the PNF objectNot Applicable

    ONT NNI Port


    CPE PNF onboarding in SDC


    OLT NNI Slot


    PNF registration event


    OLT NNI Port


    PNF registration event



    TOSCA Models


    Code Block
    languageyml
    titleHSIA Access RFS : CPE
    linenumberstrue
    collapsetrue
    tosca_definitions_version: tosca_simple_yaml_1_0_0
    node_types: 
      org.openecomp.resource.vfc.OntPnf: #we cannot use the namespace like "tosca.nfv.nodes" cause SDC's restriction
        derived_from: org.openecomp.resource.abstract.nodes.PNF
        properties:
          cpe_id:
            type: string
            required: true
          pnf_name:
            type: string
            required: true
          mac_addr:
            type: string
            required: true
          manufacturer:
            type: string
            required: true
          serial_num:
            type: string
            required: true
          model:
            type: string
            required: true
          attachment_point:
            type: string
            required: true
          is_pnf: # temporary parameter
            type: boolean
            required: true
            default: true
    #      ont_type: reuse nf_type in Generic_PNF
    #        type: string
    #        required: true
    #      ont_sw_version: reuse software_versions in Generic_PNF
    #        type: string
    #        required: true
        capabilities:
            virtual_binding:
              type: tosca.capabilities.nfv.VirtualBindable
              occurrences:
              - 1
              - UNBOUNDED

    CpePnf.yml

    Code Block
    languageyml
    titleHSIA Access RFS : AccessConnectivity
    linenumberstrue
    collapsetrue
    tosca_definitions_version: tosca_simple_yaml_1_0_0
    node_types: 
      org.openecomp.resource.vfc.accessConnectivity: 
        derived_from: tosca.nodes.Root
        description: olt
        properties:
          service_type:
            type: string
            required: true
          upstream_speed:
            type: string
            required: true
          downstream_speed:
            type: string
            required: true
        capabilities:
            virtual_binding:
              type: tosca.capabilities.nfv.VirtualBindable
              occurrences:
              - 1
              - UNBOUNDED

    access_connectivity.yml

    Code Block
    languageyml
    titleHSIA Access RFS : OntNni
    linenumberstrue
    collapsetrue
    tosca_definitions_version: tosca_simple_yaml_1_0_0
    node_types: 
      org.openecomp.resource.cp.OntNni: 
        derived_from: tosca.nodes.nfv.VduCp
        properties:
          ont_port:
            type: string
            required: true
        requirements:
            - virtual_link:
                capability: tosca.capabilities.nfv.VirtualLinkable
                relationship: tosca.relationships.nfv.VirtualLinksTo
                node: tosca.nodes.nfv.VnfVirtualLink
            - virtual_binding:
                capability: tosca.capabilities.nfv.VirtualBindable
                relationship: tosca.relationships.nfv.VirtualBindsTo
                node: org.openecomp.resource.vfc.OntPnf
    

    OntNni.rar

    Code Block
    languageyml
    titleHSIA Access RFS : PonUni
    linenumberstrue
    collapsetrue
    tosca_definitions_version: tosca_simple_yaml_1_0_0
    node_types: 
      toscaorg.openecomp.nodesresource.nfvcp.PonUni: 
        derived_from: tosca.nodes.nfv.VduCp
        properties:
          expected_ont_id:
            type: string
            required: true
          cvlan_id:
            type: string
            required: true
          olt_name:
            type: string
            required: true
          olt_pon_port:
            type: string
            required: true
          olt_pon_slot:
            type: string
            required: true
        requirements:
            - virtual_link:
                capability: tosca.capabilities.nfv.VirtualLinkable
                relationship: tosca.relationships.nfv.VirtualLinksTo
                node: tosca.nodes.nfv.VnfVirtualLink
            - virtual_binding:
                capability: tosca.capabilities.nfv.VirtualBindable
                relationship: tosca.relationships.nfv.VirtualBindsTo
                node: org.openecomp.resource.vfc.accessConnectivity
    
    
    

    PonUni.rar

    Code Block
    languageyml
    titleHSIA Access RFS : OLTNNI
    linenumberstrue
    collapsetrue
    tosca_definitions_version: tosca_simple_yaml_1_0_0
    node_types: 
      toscaorg.openecomp.nodesresource.nfvcp.OltNni: 
        derived_from: tosca.nodes.nfv.VduCp
        properties:
          olt_name:
            type: string
            required: true
          olt_nni_port:
            type: string
            required: true
          olt_nni_slot:
            type: string
            required: true
          svlan:
            type: string
            required: true        
        requirements:
            - virtual_link:
                capability: tosca.capabilities.nfv.VirtualLinkable
                relationship: tosca.relationships.nfv.VirtualLinksTo
                node: tosca.nodes.nfv.VnfVirtualLink
            - virtual_binding:
                capability: tosca.capabilities.nfv.VirtualBindable
                relationship: tosca.relationships.nfv.VirtualBindsTo
                node: toscaorg.openecomp.nodesresource.nfvvfc.OltPnfaccessConnectivity
    
    
    Info

    HSIA Edge RFS proposal from Victor.

  • CP derived from tosca.nodes.nfv.vduCp
  • Connectivity will reuse tosca.nodes.nfv.VnfVirtualLink
  • To be edited, the requirements for virutal_binding depends on how to model the BNG itself.

    OltNni.rar

    Code Block
    languageyml
    titleHISA Edge HSIA Access RFS : BngUniInternetProfile
    linenumberstrue
    collapsetrue
    tosca_definitions_version: tosca_simple_yaml_1_0_0
    node_types: 
      toscaorg.openecomp.nodesresource.nfvvfc.BngUniInternetProfile: 
        derived_from: tosca.nodes.nfv.VduCpRoot
        properties:
          svlanrg_mac_addr:
            type: string
            required: true
          bngservice_uni_porttype:
            type: string
            required: true
          bngupstream_uni_slotspeed:
            type: string
            required: true
          
        requirementsdownstream_speed:
            - virtual_linktype: string
            required: true
     capability: tosca.capabilities.nfv.VirtualLinkable    remote_id:
            relationshiptype: tosca.relationships.nfv.VirtualLinksTostring
            required: true
      node: tosca.nodes.nfv.VnfVirtualLink
     capabilities:
           - virtual_binding:
                capabilitytype: tosca.capabilities.nfv.VirtualBindable
                relationshipoccurrences:
    tosca.relationships.nfv.VirtualBindsTo          -   node: tosca.nodes.nfv.BNG //To Be Edited, depends on how to model BNG itself
    
    
    1
              - UNBOUNDED
    

    InternetProfile.yaml