XGVela use of TM Forum APIs

Vance Shipley
SigScale

© 2020 TM Forum | 1
TM Forum Overview
“We are an alliance of 850+ global companies
working together to break down technology and
cultural barriers between digital service providers,
technology suppliers, consultancies and systems
integrators.”

© 2020 TM Forum | 2
Transition to Digital Service Provider (DSP)
The TM Forum has been known for decades as the standards
development organization (SDO) responsible for telco operations and
business support systems (OSS/BSS).
Today we are focused on the transition from traditional communications
service providers (CSP) to agile digital service providers (DSP).

© 2020 TM Forum | 3
TM Forum Frameworx
Business Process Framework (eTOM)
A comprehensive, industry-agreed, multi-layered
view of the key business processes required to run
an efficient, effective and agile digital service
provider.
Information Framework (SID)
Provides standard definitions for all the information
that flows through the enterprise and between
partners, enabling critical insights for platform
economy business.
© 2020 TM Forum | 4
eTOM Domains & Context Verticals

Context Verticals Strategy to Readiness Operations

categorize the processes

Strategy Capability Lifecycle Operations Fulfillment Assurance Billing &
Management Delivery Management Readiness & Revenue
Support Management

that are required to Market & Sales

support customers and to Customer

manage the business.
Product

Common
Functional process Service

groupings (domains) form Resource

the apex of the process Business Partner

decomposition hierarchy
Enterprise
we use to contain, find
and define our processes.
© 2020 TM Forum | 5
eTOM Operations
The Operations context vertical includes the three pillars of any service
provider business:
• Fulfillment
• Assurance
• Billing Fulfillment Assurance Billing & Revenue
Management

Service
Service Problem Service Quality Service Guiding &
Service Domain Configuration and
Management Management Mediation
Activation

Resource Resource
Resource Resource Trouble
Performance Mediation &
Provisioning Management
Management Reporting
Resource Domain

Resource Data Collection & Distribution

© 2020 TM Forum | 6
Open Digital Architecture (ODA) (GB999)
Production block of ODA Functional Architecture contains Service and
Resource domain functions. End-to-end service management functions
provide customer facing services (CFS) which may go into Products
managed by Core Commerce functions.

© 2020 TM Forum | 7
Management & Orchestration
“TM Forum introduces the concept of a coherent
and consistent mode of operation where
management and control activities are
considered as one continuum.”

© 2020 TM Forum | 8
Essential Elements of Orchestration (IG1139)

• Federated Domains
• Standardized Patterns
• Declarative Interfaces
• Autonomic Control Loops
• Security Practices and Infrastructure
• Assurance
• Culture and Governance

© 2020 TM Forum | 9
XGVela Support of Operations Processes

OSS
Operations Support Systems
(OSS) may (also) manage
Network Functions (NF)
through XGVela Telco PaaS. NF NF NF NF

Fulfillment, Assurance and

Billing, as well as aspects of Configuration Performance Fault Logging
Operations Readiness &
Support, are supported by Telco PaaS
common functions of the
Telco PaaS. General PaaS

© 2020 TM Forum | 10
TM Forum Open APIs with XGVela

OSS Telco PaaS

OSS may manage hosted Resource TMF634
Catalog
network functions (NF) NF
through TM Forum Open Resource
Inventory
TMF639
Configuration
APIs providing a consistent
Resource
set of interfaces widely Function TMF664 NF
adopted by the industry. Activation

Performance TMF628 Metrics

Management
NF
Fault TMF642 Events
Management
Usage TMF635 Logging
Management

https://projects.tmforum.org/wiki/display/API/Open+API+Table © 2020 TM Forum | 11

Management & Orchestration Architecture (3GPP 28.533)

3GPP defines a federated service-

based management architecture
for 5G NSMF NSSMF NFMF

Management Functions (MnF)

MnS MnS … MnS MnS MnS … MnS MnS MnS … MnS

may be producers or consumers

of Management Services (MnS)
Third party access may be CSMF
MnS MnS … MnS MnS … MnS MnS … MnS

through an Exposure Governance EGMF NF NF

Management Function (EGMF)

© 2020 TM Forum | 12
Management & Orchestration Architecture (3GPP 28.533)

Any of the 5G MnF may OSS

(optionally) be hosted with

XGVela Telco PaaS NSMF NSSMF NFMF AMF SMF UPF

Telco PaaS

General PaaS

Network Slice Management Function (NSMF)

Network Slice Subnet Management Function (NSSMF)
Network Function Management Function (NFMF)
5G Core Network Functions (NF)
Access Mobility Function (AMF)
Session Management Function (SMF)
User Plane Function (UPF) © 2020 TM Forum | 13
Multi-Domain Management
In the example shown a 5G Network
Slice exists across four separately
managed domains: 5G Core

o Core
AMF UPF
o NFVI
o RAN
N2 N3

o Transport
Transport

Touchpoints exist between models gNB SCTP VNF VNF

including: PHY

5G NR-RAN NFVI
o AMF,UPF to VNFs
o AMF N2,N3 CPs to VNFC CPs
o gNB N2,N3 Cps to AMF,UPF CPs
o gNB,VNFC Cps to Transport links
© 2020 TM Forum | 14
Resource Domain

© 2020 TM Forum | 15
Resource Management Domain

• Resource Catalog
Contains specifications
describing the common
attributes and relationships of a
set of related Resources.
• Resource Inventory
Contains descriptions of specific
instances that are based on a
particular specification.

© 2020 TM Forum | 16
Resource Inventory for Assurance (IG1217)

Resource
Fault Management (FM) and Fault Performance Inventory

Performance Management (PM)

processes require rich information
Alarm
about the Managed Objects (MO) for
Lookup
which alarms and measurements are
received. Resource

Alarms and measurements identify MO Measurement

and MO Class (MOC) by reference. Lookup

Resource
Assurance processes require MO
inventories and MOC catalogs to make
sense of the FM and PM event data.
© 2020 TM Forum | 17
Logical Resource - Computing and Software (GB922 SID)

© 2020 TM Forum | 18
Example: 5G Core Function in Resource Inventory

• Installed Software
Provides a 5G Core Access and
Mobility software application.
• Endpoints N2, N8, …, N32
Instances of service access points
of the AMF.
• AMF
An instance of a 5G Core AMF
Resource Function.

© 2020 TM Forum | 19
Information Modeling

© 2020 TM Forum | 20
Metamodels in TM Forum Open APIs
Information Model
UML
Representation of business concepts,
their characteristics and relationships, Information Model (SID)
described in an implementation
independent manner
Data Model
JSON Schema
Provides specific definition and format of {
"$id": "http://tmforum.org/schema/”,

values available to an instance

"title": “ResourceSpecification”,
"definitions": {
“foo”: {
"type": "object",
"properties": {
Data Model (Open API)
JSON Schema "id": {

},
…
"type": "string"

Defines JSON encoding included in Open

}

API Specification (OAS) (“swagger”)

Entity Specification
Specification {
"$id": “42”,

Provides a specific set of available Instance Data Model (Catalog)

"title": “Entity Specification”,
…
“characteristicSpec”: {

characteristics and features to be

…
}
…
}

included in a Catalog
Instance Model Entity

Representation of an instantiated entity

{
"$id": “72”,
"title": “Entity”,
"definitions": {
Instance Model
with values which are valid in the context
“foo”: {
"type": "object",
"properties": {
"id": {

of the Data Model }

},
"type": "string"

© 2020 TM Forum | 21
Data Model Equivalency

• Data Models derived UML

from a common Information Model

Information Model
are equivalent

• Data values used in YANG JSON Schema XML

one encoding may submodule ngc-AMFFunction { … ngc; }
import EP_RP { … ; }
import ManagedFunction { …; }
{
"$schema": "http://json-schema.org
"$id": "http://datamodel.tmforum.o
<?xml version="1.0" encoding="UTF-8"
<schema targetNamespace=“…/28.541#ng
elementFormDefault="qualified"

be mapped to
import nrm-types-3gpp { …; } "title": “AmfFunctionSpecification
attributeFormDefault="unqualifi
description "AMFFunction"; "definitions": {
xmlns="http://www.w3.org/2001/X
revision 2018-08-07 { “AMFFunction”: {
<import namespace="http://www.3gpp.o
description "Initial revision"; "type": "object",
<complexType name="aMFIdentifier">
} "properties": {

values for another

<sequence>
grouping AMFFunction { "id": {
<element name="amfRegionId
uses mf:ManagedFunction; "type": "string"
</sequence>
},
</complexType>
list pLMNId { …

encoding

Data Model Data Model Data Model

© 2020 TM Forum | 22
FMC FNIM Umbrella Information Model (UIM)(3GPP 32.107)

UIM maps simply to TM Forum

Information Framework (SID):

© 2020 TM Forum | 23
Generic Network Resource Model (NRM) (3GPP 32.622)
SubNetwork
set of managed entities
ManagementNode
element manager (EM)

ManagedElement
network element (NE)

ManagedFunction
for sub-classing only
represents a telecommunication
function (e.g. NetworkSlice, AMF)

Endpoint (EP_RP)
represents an end point of a link across
a reference point (e.g. X2, N1)
© 2020 TM Forum | 24
5G Network Resource Model (NRM)(3GPP 28.541)
5G Network Slice NRM and ETSI NFV Information Model
NetworkSlice
network slice instance
NetworkSliceSubnet
network slice subnet instance
ManagedFunction
5GC Funtion (AMF, SMF, UPF, …)
NetworkService
composition of Network Functions
(NF) representing a group of VNFs
and PNFs that are supporting the
network slice subnet instance
VNF
NF deployed on NFVI
Figure 6.2.1-1: Network slice NRM fragment relationship
© 2020 TM Forum | 25
Fault Management (FM) Information Model (3GPP 32.111-2, ITU X.721)
The information model for an “alarm”
is more prescriptive than most
implementors realize
The categorization of alarms, in
increasing level of detail, requires:
alarmType: one of a small number of
enumerated values
probableCause: one of a large number
of enumerated values
specificProblem: index into context
specific list

© 2020 TM Forum | 26
Questions?

Vance Shipley <[email protected]>

SigScale

© 2020 TM Forum | 27