11. ANNEX 3: OSM Information Model

11.1. YANG model in OSM repos

YANG models can be found in the IM repo under the models folder: https://osm.etsi.org/gitweb/?p=osm/IM.git;a=tree

OSM uses pyang and pyangbind to generate Python classes used by the different OSM components.

Since Release NINE, OSM IM is fully aligned with ETSI NFV SOL006. OSM Information Model augments ETSI NFV SOL006 YANG models by adding the support of Network Slices, day-1 and day-2 primitives at VNF and NS level, and Enhanced Platform Awareness for dataplane workloads. Augments can be found in this folder: https://osm.etsi.org/gitweb/?p=osm/IM.git;a=tree;f=models/augments

11.2. OSM IM tree representation

Below you can find tree representations of the VNFD (VNF Descriptor), NSD (Network Service Descriptor), NST (Network Slice Template), VNFR (VNF Record), NSR (Network Service Record), NSI (Network Slice Instance), both in navigable and plain text formats.

11.2.1. VNFD tree

11.2.2. NSD tree

11.2.3. NST tree

11.3. OSM URN Namespace

11.3.1. Introduction

OSM is maintaining a namespace registry as a sub tree of the ETSI root urn:etsi namespace. A description of the top level ETSI URN namespace can be found on the ETSI PNNS page

The OSM URN namespace has the following structure:

urn:etsi:osm:<OSM sub-tree>

The following sections describe the basic structure of the sub-tree and how a entry in the registry can be requested.

11.3.2. OSM sub-tree

OSM sub-tree Full Namespace Type Description
yang urn:etsi:osm:yang string Namespace for YANG modules specified in OSM.OSM/IM.git
yang:augments urn:etsi:osm:yang:augments string Namespace for YANG modules specified in OSM augmenting SOL006.OSM/IM.git Type definitions

string = (ALPHA)0*(ALPHANUMERIC/-/_)
## a string starts with an upper- or lower-case letter followed by zero or more upper- or lower-case letters, integer numbers, hyphens or underscores

ALPHA = {a-zA-Z}

11.3.3. Requesting an entry

The procedure to request an entry is described as follows.

  • Step #1: Send an e-mail to the OSM_TSC@list.etsi.org mailing list indicating the name of the sub-tree, the contact person and the purpose of that subtree.

  • Step #2: The TSC will review the proposal.

    • If the application is accepted, a new entry in the “OSM URN Namespace” will be enabled.

    • If the application cannot be accepted, it will be communicated to the contact person together with any additional information to be considered for resolving the “non-acceptance”.

11.4. Release EIGHT DESCRIPTOR Documentation (OLD)

The link below contains a detailed description of the OSM Release EIGHT Information Model, previous to the alignment to ETSI NFV SOL006. It can still be used as a reference to compare the previous IM and the current IM.

OSM Release EIGHT Information Model

11.5. Release TWO Descriptor Documentation (OLD)

The document below contains a detailed description of the OSM Release TWO Models. Although a bit outdated, it can still be used as a reference to understand some of the fields in the VNFD and NSD.

OSM Release TWO Information Model