Versions Compared

Old Version 19

changes.mady.by.user Xu Yang

Saved on

compared with

New Version 20

changes.mady.by.user Xu Yang

Saved on

Key

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

...

  • Design Time Model

    1) ONAP Resource Model UML

    Questions:
      - It's stated in the AID document that "a service component has a zero to many relationship to service while the vnf component has is related to exactly one vnf"? What's the case for a service component to have zero relationship to service? Does it imply that a service component can exist alone (without being involved in a service) in design time?




  • 2) ETSI IFA IM (IFA015 VNFD)

    (besides VduCpd, Vdu also has relationship with VirtualComputeDesc, VirtualStorageDesc and swImageDesc; which are omitted in this diagram)

    3) SDC IM (normative and heat types)

...

  • VNFC Run Time Model

    AAI (aai_schema_v11 vnfc)ECOMP IM (VNFC Instance)ETSI IFA008 (VnfcInfo)CommentDescription
    vnfc-name
    		vnfcInstanceId
    		identifier of the vnfc instance
    nfc-naming-code

    Xu Yang: Need specification/reference for the value of this attribute? Xu Yang: Should the attribute name aligned to "vnfc"?

    James Forsyth: No, in a network function we should not care if it's physical or virtual

    		short code of the vnfc instance
    nfc-function

    Xu Yang: Should the attribute name aligned to "vnfc"?
    James Forsyth No, in a network function we should not care if it's physical or virtual

    		description of the vnfc instance
    prov-status

    Xu Yang: need further clarification on how this attribute is used
    James Forsyth: Service assurance systems use this status in their logic to determine the provisioning status.  Values such as: PROVISIONED, PREPROVISIONED, CAPPED might be stored in this attribute

    		Trigger for operational monitoring of this resource by Service Assurance systems
    orchestration-status
    		vnfcState

    Xu Yang: Is it the same as vnfcState (i.e., start or stop)?
    James Forsyth: Used for lifecycle management.  We don't know what vnfcState is.

    Xu Yang: vnfcState describes the state of a VNFC instance, possible values are: STARTED, STOPPED. STARTED means the VNFC instance is up and running, and STOPPED means the VNFC instance has been shut down (but not terminated/deleted). Similar to the VM power on/off concept.

    		Orchestration status of this VNF, mastered by APP-C
    ipaddress-v4-oam-vip

    Xu Yang: Is this attribute mandatory? and applicable for all kinds of VNFCs?
    James Forsyth: Not mandatory and this field should be deprecated in ONAP

    		Oam V4 vip address of this vnfc
    in-maint

    Pamela Dragosh: DCAE monitors this flag. If set it does not "observe" alarms/traps/etc. during control loop.

    		whether in maintenance mode
    is-closed-loop-disabled

    Xu Yang: used by DCAE?
    James Forsyth: There are closed loop actions that DCAE might have policies for, and operations can turn off those actions with this flag

    Pamela Dragosh: Yes actually Policy has the rules that check for this. DCAE does not. DCAE does however check the in-maint flag.

    		used to indicate whether closed loop function is enabled on this node
    group-notation

    Xu Yang: need further clarification on how this attribute is used
    James Forsyth: In some applications, a two or more VMs or VNFCs is referred to by a name, and group-notation represents the name.  Might want to use instance-group to replace this over time.

    		Group notation of VNFC
    model-invariant-id
    		vduId
    		the SDC model id for this resource model
    model-version-id


    		the SDC model version for this resource model
    resource-version

    Xu Yang: Is it used internally in AAI? can be omitted in the general model.
    James Forsyth: It's used internally in AAI to enforce concurrency control, other systems use it to pass to AAI on updates and delete operations.  It can be omitted from the general model

    		Used for optimistic concurrency.  Must be empty on create, valid on update and delete
    l3-interface-ipv4-address-list


    		l3 interface addresses, ipv4
    l3-interface-ipv6-address-list


    		l3 interface addresses, ipv6
    relationship-listassociation (VM, Docker, LXC)

    		AAI: relationship with vserver, vf-module and generic-vnf

...

  • VNF Run Time Model

    AAI (generic_vnf)ECOMP IM (VNF instance)ETSI IFA007 (VnfInfo)CommentDescription
    vnf-id
    		vnfInstanceId
    		identifier of the vnf instance
    vnf-name
    		vnfInstanceName
    		name of the vnf instance
    vnf-name2

    Xu Yang: use case for alternative name?
    James Forsyth: Customer want aliases, so this is an alias for a VNF

    		alternative name of the vnf instance
    vnf-typeVFType

    Xu Yang: Is there any reference/specification for the value of this attribute?
    James Forsyth: This attribute should be deprecated, it was used prior to SDC modelling

    		String capturing type of vnf, that was intended to identify the ASDC resource. This field has been overloaded in service-specific ways and clients should expect changes to occur in the future to this field as ECOMP matures.
    service-id

    Xu Yang: deprecated?
    James Forsyth:
    This attribute should be deprecated, it was used prior to SDC modelling

    		Unique identifier of service, does not necessarily map to ASDC service models.  SOON TO BE DEPRECATED
    regional-resource-zone


    		Regional way of organizing pservers, source of truth should define values
    prov-status

    Xu Yang: Need clarification, similar to vnfc instance model.
    James Forsyth: Service assurance systems use this status in their logic to determine the provisioning status.  Values such as: PROVISIONED, PREPROVISIONED, CAPPED might be stored in this attribute

    		Trigger for operational monitoring of this resource by Service Assurance systems.
    operational-status

    Xu Yang: Need clarification on how this attribute is used.
    James Forsyth: Used for lifecycle management.

    Xu Yang: Are the valid values "in-service-path" and "out-of-service-path"? Don't understand what do these values mean, in use or not in use by a service?

    		Indicator for whether the resource is considered operational. Valid values are in-service-path and out-of-service-path.
    license-key

    Xu Yang: deprecated?
    James Forsyth Yes

    		OBSOLETE -  do not use
    equipment-role

    Xu Yang: Please clarify the usage of this attribute.
    James Forsyth: Deprecated

    		Client should send valid enumerated value
    orchestration-status

    Xu Yang: only used by SO?
    James Forsyth: Used by anyone who wants to check it, set by SO

    Xu Yang: could you elaborate more on the valid values and their meaning?

    		Orchestration status of this VNF, used by SO.
    heat-stack-id

    Xu Yang: only used by SO?
    James Forsyth: Not being used anymore, deprecated.

    		Heat stack id corresponding to this instance, managed by SO
    mso-catalog-key

    Xu Yang: only used by VCE?
    James Forsyth: Predates SDC modelling, deprecated

    		Corresponds to the SDN-C catalog id used to configure this VCE
    management-option

    Xu Yang: Need clarification on how this attribute is used.
    James Forsyth: indicates who manages a specific resource, whether it's the service provider or a customer

    		identifier of managed by service provider or customer
    ipv4-oam-address

    Xu Yang: Is this attribute mandatory? and applicable for all kinds of VNFs? (same question as VNFC instance model)
    James Forsyth: Not mandatory, and it can be applicable for all kinds of VNFs, depending on the requirements of the VNF

    		Address tail-f uses to configure generic-vnf, also used for troubleshooting and is IP used for traps generated by generic-vnf.
    ipv4-loopback0-address

    Xu Yang: same as above
    James Forsyth: Not mandatory, and it can be applicable for all kinds of VNFs, depending on the requirements of the VNF

    		v4 Loopback address
    nm-lan-v6-address

    Xu Yang: same as above
    James Forsyth: Not mandatory, and it can be applicable for all kinds of VNFs, depending on the requirements of the VNF

    		v6 Loopback address
    management-v6-address

    Xu Yang: same as above
    James Forsyth: Not mandatory, and it can be applicable for all kinds of VNFs, depending on the requirements of the VNF

    		v6 management address
    vcpu

    Xu Yang: only used by uCPE?
    James Forsyth: Yes

    		number of vcpus ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
    vcpu-units

    Xu Yang: only used by uCPE?
    James Forsyth: Yes

    		units associated with vcpu, used for VNFs with no vservers/flavors, to be used only by uCPE
    vmemory

    Xu Yang: only used by uCPE?
    James Forsyth: Yes

    		number of GB of memory ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only by uCPE
    vmemory-units

    Xu Yang: only used by uCPE?
    James Forsyth: Yes

    		units associated with vmemory, used for VNFs with no vservers/flavors, to be used only by uCPE
    vdisk

    Xu Yang: only used by uCPE?
    James Forsyth: Yes

    		number of vdisks ordered for this instance of VNF, used for VNFs with no vservers/flavors, to be used only uCPE
    vdisk-units

    Xu Yang: only used by uCPE?
    James Forsyth: Yes

    		units associated with vdisk, used for VNFs with no vservers/flavors, to be used only by uCPE
    in-maint


    		indicate whether or not this object is in maintenance mode (maintenance mode = true). This field (in conjunction with prov-status) is used to suppress alarms and vSCL on VNFs/VMs
    is-closed-loop-disabled


    		indicate whether closed loop function is enabled on this node
    resource-version

    Xu Yang: Is it used internally in AAI? can be omitted in the general model.
    James Forsyth: It's used internally in AAI to enforce concurrency control, other systems use it to pass to AAI on updates and delete operations

    		Used for optimistic concurrency.  Must be empty on create, valid on update and delete.
    summary-status

    Xu Yang: deprecated?
    James Forsyth: Yes

    		details regarding the generic-vnf operation, PLEASE DISCONTINUE USE OF THIS FIELD.
    encrypted-access-flag


    		indicates whether generic-vnf access uses SSH
    entitlement-assignment-group-uuid

    Xu Yang: deprecated?
    James Forsyth Yes

    		UUID of the Entitlement group used for licensing VNFs, OBSOLETE -  See child relationships.
    entitlement-resource-uuid

    Xu Yang: deprecated?
    James Forsyth Yes

    		UUID of the specific entitlement resource.  OBSOLETE -  See child relationships
    license-assignment-group-uuid

    Xu Yang: deprecated?
    James Forsyth Yes

    		UUID of the license assignment group.  OBSOLETE -  See child relationships.
    license-key-uuid

    Xu Yang: deprecated?
    James Forsyth Yes

    		UUID of the actual license resource.  OBSOLETE -  See child relationships.
    model-invariant-idVNF Model IdvnfdId
    		identifier of the VNF model
    model-version-idVNF Model VersionvnfdVersion
    		version of the VNF model
    persona-model-version

    Xu Yang: It seems to be used internally in AAI, need clarification on the usage of this attribute.
    James Forsyth Deprecated, use model-version-id

    		the ASDC model version for this resource or service model
    model-customization-id
    		vnfConfigurableProperty
    		captures the id of all the configuration used to customize the resource for the service
    widget-model-id

    Xu Yang: Is it used internally in AAI? Can be omitted in general model
    James Forsyth It's never been populated, yes can be omitted

    		the ASDC data dictionary widget model. This maps directly to the A&AI widget.
    widget-model-version

    Xu Yang: Is it used internally in AAI? Can be omitted in general model
    James Forsyth It's never been populated, yes can be omitted

    		the ASDC data dictionary version of the widget model.This maps directly to the A&AI version of the widget.
    as-number

    Xu Yang: Please clarify the usage of this attribute.
    James Forsyth Has to do with routing, not applicable for all VNFs

    		as-number of the VNF
    regional-resource-subzone


    		Regional way of organizing pservers, source of truth should define values
    nf-type

    Xu Yang: What's the difference between vnf-type and nf-type?
    James Forsyth - we are getting rid of vnf-type and replacing with nf-type, nf-function, and nf-role

    		Generic description of the type of NF
    nf-function
    		vnfInstanceDescription
    		description of the VNF instance
    nf-roleNetworkRole

    		role in the network that this model will be providing
    nf-naming-code


    		string assigned to this model used for naming purposes
    selflink

    Xu Yang: what controller?
    James Forsyth: Not sure if it's being populated

    		Path to the controller object
    ipv4-oam-gateway-address

    Xu Yang: Is this attribute mandatory? and applicable for all kinds of VNFs?
    James Forsyth There should be an edge to a network that has a gateway assigned to it, so this attribute should be deprecated

    		Gateway address
    ipv4-oam-gateway-address-prefix-length

    Xu Yang: same as above
    James Forsyth There should be an edge to a network that has a gateway assigned to it, so this attribute should be deprecated

    		Prefix length for oam-address
    vlan-id-outer

    Xu Yang: only used by VCE?
    James Forsyth Not sure

    		Temporary location for S-TAG to get to VCE
    nm-profile-name


    		Network Management profile of this VNF
    relationship-list

    Xu Yang: Is the description correct?
    James Forsyth - The edge rules has the exhaustive list of possible relationships for generic-vnf

    relationship with l-interface, availability-zone, lag-interface, l3-network, pserver, vserver, service-instance, vf-module, volume-group, vnfc and logical-link

    l-interfaces


    		logical interfaces
    lag-interfaces


    		Collection of link aggregate interfaces
    vf-modules


    		a deployment unit of VNFCs
    licenses


    		license information
    entitlements


    		entitlement information

    		HomingPolicy

    		Reference to VNF-level homing policy that ECOMP will use when VNF deployment target node is auto-selected

    		TargetNodePrompt

    "Y" indicates operator-supplied VNF instance target deployment node required. Present prompt to operator: "Enter target node for deployment of this VNF instance"

    "N" indicates that the target deployment node for this VNF instance will be auto-selected by ECOMP

    		VLAN Range Plan

    		Identifies the VNF-level VLAN Range Plan that must be used by ECOMP to assign VLAN tags to an instance of this VNF type

    		VNF Name Prompt

    "Y" indicates operator-supplied VNF name required. Present prompt to operator: "Enter the name for this VNF instance"

    "N" indicates that the name for the VNF instance will be auto-generated by ECOMP

    		VNF Naming Policy

    		Reference to VNF-level naming policy that ECOMP will use when VNF-level name is auto-generated

    		VNF Network Tag

    		Must correlate to the set of defined “network-role” identifiers from the associated HEAT templates


    		vnfSoftwareVersion

    Software version of the VNF. This is changed when there is any change to the software that is included in the VNF
    Package.



    		vnfProvider
    		Provider of the VNF and of the VNFD.


    		vnfProductName

    Name to identify the VNF Product. Invariant for the VNF Product lifetime.



    		onboardedVnfPkgInfoId

    Identifier of the specific VNF Package on which the VNF is based.



    		instantiationState
    		The instantiation state of the VNF instance.

    Possible values: NOT_INSTANTIATED (VNF instance is terminated or not instantiated, and the identifier of the VNF instance exists), INSTANTIATED (VNF instance is instantiated).



    		instantiatedVnfInfo

    Information specific to an instantiated VNF instance. Shall be present if the VNF is in INSTANTIATED instantiation state.



    		metadata

    Additional VNF-specific metadata describing the VNF instance.



    		extension

    VNF-specific attributes that affect the lifecycle management of this VNF instance by the VNFM, or the lifecycle management scripts.

...