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 |
11.3.2.1. 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}
ALPHANUMERIC = {a-zA-Z0-9}
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.
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.