Instantiation

[openBackhaul]

There is a problem in instantiating a Profile, if no instance that could be cloned would already exist. Particularly, since the capabilities are attached to the instances of Profile.

Potential Solution:

• If not assured that there is always at least one instance of Profile, an RPC shall be defined.
• This RPC shall
  • either generate a default Profile, which can serve as a prototype for clones,
  • or create and edit actual instances of Profile.

[openBackhaul]

An RPC based solution has been defined in the SchedulerProfile. It covers

• creating an instance
• modifying an existing instance
• deleting an instance

Would it make sense to replicate this solution here?

[demx8as6]

Decision at the 5G-xhaul call on 15th of March 2023: The following changes shall be made to the UML modelling of the QosProfile:

An Interface of name QosProfileOperations shall be created.

An Operation of name createQosProfile shall be created. It shall NOT be idempotent, but create a new instance of QosProfile with every call. It shall be atomic. It shall have the following optional input parameter:

• _baseQosProfile:Profile [0..1] with comment "If filled with an UUID of an existing instance of QosProfile, the RPC shall create a duplicate of the existing instance. If the attribute is not provided, the device shall create a QosProfile according to an internal default."

It shall have the following output parameter:

• _createdQosProfile:Profile [1] with comment "UUID of the instance of QosProfile that has been newly created."

An Operation of name modifyQosProfile shall be created. It shall be idempotent It shall be atomic It shall have the following mandatory input parameter:

• _qosProfileToBeModified [1] with a reference to an existing Profile with Profile(ProfileNameType==PROFILE_NAME_TYPE_QOS_PROFILE) and comment 'UUID of the instance of QosProfile that shall be modified.'.

It shall have the following optional input parameters (if not provided, the configured values shall not be touched):

• externalLabel:String [0..1] = 'External label not yet defined.' with comment "Identifier of the instance of QosProfile. Could be a name, could be a number. Free text field to be filled by the operator.'.
• queueDepthList:QueueDepthType [0..8] with comment 'Facilitates configuring the depth of the individual queues.'.
• qosProfileKind:QosProfileKindType [0..1] = 'NOT_YET_DEFINED' with comment 'Defines whether the sorting into queues is done based on VLAN, MPLS or IP header information.'.
• ingress8021pToPerHopBehaviorMappingList:PerHopBehaviorType [0..8] with comment 'Only relevant when qosProfileKind == IEEE8021P. Associates the value of the three p-bits of the VLAN header with a per hop behavior at the physical interface. First entry in the list [0] relates to p-bit value '0'. Last entry in the list [7] relates to p-bit value '7'.'.
• ingressExpToPerHopBehaviorMappingList:PerHopBehaviorType [0..8] with comment 'Only relevant when qosProfileKind == MPLS_EXP. Associates the value of the three p-bits of the MPLS header with a per hop behavior at the physical interface. First entry in the list [0] relates to p-bit value '0'. Last entry in the list [7] relates to p-bit value '7'.'.
• ingressIpDscpToPerHopBehaviorMappingList:PerHopBehaviorType [0..64] with comment 'Only relevant when qosProfileKind == IP_DSCP. Associates the value of the 8 dscp bits of the IP header with a per hop behavior at the physical interface. First entry in the list [0] relates to dscp value '0'. Last entry in the list [63] relates to dscp value '63'.'.
• writingPerHopBehaviorInto8021pIsOn:Boolean [0..1] = false with comment 'true = Original content of 802.1p bits is overwritten with local per hop behavior.'.
• egressPerHopBehaviorTo8021pMappingList:EgressPerHopBehaviorToPriorityBitsMappingType [0..24] with comment 'Only relevant if (writingPerHopBehaviorInto8021pIsOn==true). Translates (queue and drop precedence) into values of the three p-bits of the VLAN header.'.
• writingPerHopBehaviorIntoMplsExpIsOn:Boolean [0..1] = false with comment 'true = Original content of MPLS EXP bits is overwritten with local per hop behavior.'.
• egressPerHopBehaviorToMplsExpMappingList:EgressPerHopBehaviorToPriorityBitsMappingType [0..24] with comment 'Only relevant if (writingPerHopBehaviorIntoMplsExpIsOn==true). Translates (queue and drop precedence) into values of the three p-bits of the MPLS header.'.
• writingPerHopBehaviorIntoIpDscpIsOn:Boolean [0..1] = false with comment 'true = Original content of IP DSCP bits is overwritten with local per hop behavior.'.
• egressPerHopBehaviorToIpDscpMappingList:EgressPerHopBehaviorToPriorityBitsMappingType [0..24] with comment 'Only relevant if (writingPerHopBehaviorIntoIpDscpIsOn==true). Translates (queue and drop precedence) into values of the six dscp bits of the IP header.'.

An Operation of name deleteQosProfile shall be created. It shall be idempotent. It shall be atomic. It shall have the following input parameter:

• _obsoleteQosProfile:Profile [1] with comment "UUID of the instance of QosProfile that shall be deleted."

The existing modelling shall be changed in the following aspects:

• QosProfile_Pac::_wredProfileConfiguration shall change from read/write to read-only.
• QosProfileConfiguration::externalLabel shall change from read/write to read-only.
• QosProfileConfiguration::queueDepthList shall change from read/write to read-only.
• QosProfileConfiguration::qosProfileKind shall change from read/write to read-only.
• QosProfileConfiguration::ingress8021pToPerHopBehaviorMappingList shall change from read/write to read-only.
• QosProfileConfiguration::ingressExpToPerHopBehaviorMappingList shall change from read/write to read-only.
• QosProfileConfiguration::ingressIpDscpToPerHopBehaviorMappingList shall change from read/write to read-only.
• QosProfileConfiguration::writingPerHopBehaviorInto8021pIsOn shall change from read/write to read-only.
• QosProfileConfiguration::egressPerHopBehaviorTo8021pMappingList shall change from read/write to read-only.
• QosProfileConfiguration::writingPerHopBehaviorIntoMplsExpIsOn shall change from read/write to read-only.
• QosProfileConfiguration::egressPerHopBehaviorToMplsExpMappingList shall change from read/write to read-only.
• QosProfileConfiguration::writingPerHopBehaviorIntoIpDscpIsOn shall change from read/write to read-only.
• QosProfileConfiguration::egressPerHopBehaviorToIpDscpMappingList shall change from read/write to read-only.

[openBackhaul]

UML changed as described above.