Page History

Use case driven topology representations

Geographical Topology

Physical Topology

Ethernet Topology

PTP-Topology

Initial draft proposal

''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''' 
' Copyright 2021 highstreet technologies GmbH
' Licensed under the Apache License, Version 2.0 (the "License"); 
' you may not use this file except in compliance with the License. 
' You may obtain a copy of the License at 
' 
' http://www.apache.org/licenses/LICENSE-2.0 
' 
' Unless required by applicable law or agreed to in writing, software 
' distributed under the License is distributed on an "AS IS" BASIS, 
' WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
' See the License for the specific language governing permissions and 
' limitations under the License. 

@startuml

' Diagram 
title 
  Abstract Topology Model
end title

package AbstractTopology {
  interface Top {
    UUID Identifier
    String Name
    String Label
    ENUM LifeCycleState
        ENUM OperationalState
        ENUM AdminstrativeState
  }
  class Topology implements Top
  class Node implements Top
  class Edge implements Top
  class Path implements Top
}

Topology *--> "*" Node: hasNodes
Topology *--> "*" Edge: hasEdges
Topology *--> "*" Path: hasPaths
Node *--> "*" Node: hasChildren
Node *--> "*" Node: hasNeighborsOfSameType
Edge *--> "*" Edge: hasChildren
Edge "1" o--> "2" Node: refrencesNodesOfSameType
Path "1" o--> "*" Edge: referencesLinks


' End Diagram
' Format
header
  <b><font color=#8888ff>License</font></b>
  <b><font color=#8888ff>Apache 2.0</font></b>
end header

right footer 
  Thanks to plantUml! 
  2021-01-29 | onap.org
end footer

skinparam backgroundColor #fefefe

skinparam backgroundColor #fefefe
'skinparam handwritten true
skinparam roundcorner 15

skinparam class {
  BorderColor #444444
  BackgroundColor #ffffdd
  FontColor #444444
}

skinparam database {
  BorderColor #444444
  BackgroundColor #ffffdd
  FontColor #444444
}

skinparam sequence {
  MessageAlign left
  ArrowThickness 2
  ArrowColor #2277dd
  ArrowFontColor #444444
  ActorBorderColor #444444
  LifeLineBorderColor #444444
  LifeLineBackgroundColor #eeeeee
 
  BoxBorderColor #444444
    
  GroupBorderColor #444444
  GroupBackgroundColor #eeeeee
  
  ParticipantBorderColor #444444
  ParticipantBackgroundColor #ffffdd
  ParticipantFontColor #444444
    
  ActorBackgroundColor #ffffdd
  'ActorFontColor DeepSkyBlue
  'ActorFontSize 17
  'ActorFontName Aapex
}
@enduml

Principals

Topology is not:

• A configuration DB
• An inventory system
• Directly involved in the provisioning/execution of changes in the network

Topology is:

• a record of important entities and their relationships
• relevant to multiple applications, components, services
• multi-domain, multi-level, multi-vendor
• dynamic (@runtime) w.r.t views, topology entities and their relationships

Abstract properties:

• Connectivity: to represent the relationships between networking objects to allow traffic flow for control and data / user plane
• Containment: to represent the way networking resources (physical, virtual, logical) are instantiated, deployed and organized/structured in the network
• Ownership: to represent the relationship with the software owners of a particular network asset (physical or virtual) for a given perspective

Abstract needs:

• Topology variations: Services, Resources, Network (E.g.: Transport; RAN; Packet core; NFV Topology; ...); ...
• Grouping: to represent the way topology elements can be grouped in a topology E.g: Geographical area; vendor; ORD; ...
• State: topology entity states and their transitions. E.g. LCM (Feasible; Designed; provisioned)
• Labels: Any meta-data or information that a client may wish to associate with a topology entity

Configuration <==> Topology <==> Inventory

• Topology is derived from inventory (subset of equipment and assets) and configuration (subset of network configuration)
• Some limited replication of data as needed to provide value
• Inventory and configuration are data masters. Topology normally derived/updated based on master state. (Normally does not consider planning/intent)

Visualization

It is assumed that every topology model could be visualized. The visualization is basically a case-by-case mapping of topology-nodes and topology-edges and their properties to shapes, lines, sizes, widths and colors. Therefore the topology model itself must not take the requirements for visualization into account. In some cases a kind of profile of stylesheet could describe such mapping, but it would be outside of the topology itself.

Terms and Definitions

This chapter specifies the terms used for an abstract topology model.

Network Slicing

• Transport to RAN - RAN to Transport - RAN to Core , ....

Alarm Correlation

Multi Domain Concepts

Multi Layer

O-RU recovery (from O-RAN-SC)

The O-RAN SC (Software community) defined a closed loop use case. A trigger (Fault-Notification) by O-RU is send to SMO (ONAP components are used to build the SMO layer). A µService should listen to this trigger and will perform an configuration on the corresponding O-DU.

Please see further details of the use case description:

• https://wiki.o-ran-sc.org/pages/viewpage.action?pageId=20878423
• https://wiki.o-ran-sc.org/display/OAM/Closed+loop+use+case

• Jira
  server ONAP JIRA serverId 425b2b0a-557c-3c0c-b515-579789cceedb key CCSDK-3158

The µService needs to know the connectivity between O-DUs and O-RUs for layer "Management Plane" to send the right configuration to the the right O-DU and with the right identification of the O-RU on O-DU level. Here a complete topology of the RAN connections on ONAP level could support such use case. The use case can be easyl enhanced by adding active and passive transport components between O-RU and O-DUs.

1. Resource topology – Abstract Topology shall support the creation of a topology of network resources (VNF, VIM, NF, MF, etc.)
2. Network topology – Abstract Topology shall support the creation of a topology of how resources are connected
3. Service topology – Abstract Topology shall support the creation of a topology that represents how services use Network and Resource topologies
4. Geographical location information aware
5. Layering of topologies – client, server representation
6. State model (optional, for selected topology entities)
7. Allocation (usage, e.g. bandwidth allocation)
8. Logical grouping
9. Technology grouping
10. Dynamic
11. Cater for unmanaged assets
12. Ownership – Abstract Topology shall support association of a topology entity to the software that owns it for a given purpose (e.g.: LCM; Configuration)
13. Labels, meta-data

Candidates:

• AAI
• CPS
• SDC
• CCSDK
• DCAE