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
pagePin10

Model Design

Image Removed

Model Realization Example

Gliffy
nameModelingOLTport
pagePin5

Gliffy
nametopologyAbstraction
pagePin10

Model Parameter Life-cycle

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

BBS Parameter Table

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  Upstream Speed  Input     Input  Downstream Speed  Input    Input  Access 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)  

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)
ODN ConnectionVNF Virtual LinkN/A
Access ConnectivityVirtual Function Componentgeneric-vnfaccessConnectivity.yaml
Internet ProfileVirtual Function Componentgeneric-vnfinternetProfile.yaml
CPE (PNF)Virtual Function ComponentpnfcpePnf.yaml

Composition of services

ServiceComposed Of
HSIA CFS (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


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

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 
 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
) (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


Input (Just added after Edge/
Expand
Transport ConnectionInput
titleBBS Parameter Table for next releases R4+

BBS Parameter Table

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
Code Block
languageyml
titleHSIA Access RFS : CPE
linenumberstrue
collapsetrue
tosca_definitions_version: tosca_simple_yaml_1_0_0 node_types: tosca.nodes.nfv.Cpe: derived_from: org.openecomp.resource.abstract.nodes.PNF properties: id
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
Code Block
languageyml
firstline1
titleTOSCA model for HSIA Edge RFS
linenumberstrue
collapsetrue
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: falsetrue
<-- to be discussed       mac_addressattachment_point:
        type: string
        required: true
      is_pnf: # temporary manufacturer:parameter
        type: stringboolean
        required: true

     model:         typedefault: stringtrue
#        requiredont_type: falsereuse nf_type in     serial_number:
Generic_PNF
#        type: string
#        required: true
#       swont_sw_version: reuse software_versions in Generic_PNF
#        type: string
#        required: falsetrue
    capabilities:
        virtual_binding:
          type: tosca.capabilities.nfv.VirtualBindable
          occurrences:
          - 1
          - UNBOUNDEDUNBOUNDED

CpePnf.yml

Code Block
languageyml
titleHSIA Access RFS : OLTAccessConnectivity
linenumberstrue
collapsetrue
tosca_definitions_version: tosca_simple_yaml_1_0_0
node_types: 
  toscaorg.openecomp.nodesresource.nfvvfc.AccessConnectionaccessConnectivity: <-- to
de discussed     derived_from: tosca.nodes.rootRoot
    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 : ONTNNIOntNni
linenumberstrue
collapsetrue
tosca_definitions_version: tosca_simple_yaml_1_0_0
node_types: 
  toscaorg.openecomp.nodesresource.nfvcp.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: toscaorg.openecomp.nodesresource.nfvvfc.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: toscaorg.openecomp.nodesresource.nfvvfc.OltPnfaccessConnectivity


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: tosca.nodes.nfv.OltPnf

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.
     tosca.relationships.nfv.VirtualBindsTo
                node: org.openecomp.resource.vfc.accessConnectivity
    
    

    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       
        requirements:
            - virtual_link:
       string
             capabilityrequired: tosca.capabilities.nfv.VirtualLinkabletrue
           downstream_speed:
        relationship: tosca.relationships.nfv.VirtualLinksTo   type: string
            noderequired: tosca.nodes.nfv.VnfVirtualLinktrue
            - virtual_bindingremote_id:
            type: string
      capability: tosca.capabilities.nfv.VirtualBindable      required: true
        capabilities:
      relationship: tosca.relationships.nfv.VirtualBindsTo
           virtual_binding:
              nodetype: tosca.nodescapabilities.nfv.BNG //ToVirtualBindable
    Be Edited, depends on how to model BNG itself
    
    
    
    EntitySDC RepresentationA&AI objectONT NNIConnection Pointcp

    PON UNI

    Connection PointcpOLT NNIConnection Point

    cp

    BNG UNIN/AcpODN ConnectionVirtual Linkl3-network ??Transport ConnectionVirtual Linkl3-network ??Access ConnectivityVFCInternet ProfileVFCCPE (PNF)
       occurrences:
              - 1
              - UNBOUNDED
    

    InternetProfile.yaml