Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

SectionDescription

Information Element Name

Place Object

Points of Contact

Information Element Main Contact - Benjamin CheungJacqueline Beaulac [Ericsson]

Information Modeling Contact - Benjamin Cheung  , Jacqueline Beaulac [Ericsson]

Schema Definition Contact - Benjamin Cheung  , Jacqueline Beaulac [Ericsson]

Related Use Cases

The Place object for PNFs will first be used in R7 by the OOF / SON / PCI Use case

WIKI PAGE: R7 OOF SON Use Case

Main Contacts: Swaminathan Seetharaman  , N. K. Shankar

Participating ONAP Components

Main components affected are:

PRH (PNF Registration Handler), DCAE, OOF SON PCI Use Case Micro-service

Related JIRA

Jira Legacy
serverSystem Jira
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyMODELING-368

Description

The development of the PLACE object will introduce the ability to associate generic "place" (location) information to xNFs.

image2020-7-2_8-23-30.png

The discussion pages for model development are here: PNFD/SDC AID/AAI Schema Modeling/5G Svc Model - R7 Discussion

Related Standards & Industry Activities

Related Industry Standards are here:


Attributes

The fields are described here in this document: PNFPlaceModel_202007Jy02.xlsx

ATTRIBUTEDESCRIPTION
physical-location-id

Unique identifier for physical location, e.g., CLLI (Location ID)

TYPE: String

resource-version

Used for optimistic concurrency.  Must be empty on create, valid on update and delete.

TYPE: String

physical-location-type

Type, e.g., central office, data center.

TYPE: String

street address

A string describing the street address of the place. 

TYPE: Map

city 

The name of the metropolitan area, city, township, borough, district, or ward. The Map has with further specific city sub-divisions such as: division, borough, district, ward, chou, neighborhood, block, street group.

TYPE: Map

state

The name of the state, province

TYPE: String

postal-code

The string for the postal code or zip code

TYPE: String

country

The name of the country

TYPE: String

region

The name of the region

TYPE: String

additional qualifiers

These are additional descriptive qualifiers (general string) that may be concatenated information representing the structure qualifiers. This is a map, a tag value array of pre-defined qualifier fields including: unit, floor, room, desk

TYPE: Map

latitude

Latitude in binary geodetic form. A 34-bit fixed-point value consisting of 9 bits of integer and 25 bits of fraction. From RFC6225 (Optional)

TYPE: String

longitude

Longitude in binary geodetic form. A 34-bit fixed-point value consisting of 9 bits of integer and 25 bits of fraction. From RFC6225 (Optional)

TYPE: String

elevation

A 30-bit value defined by the Altitude Type field. From RFC6225 (Optional)

TYPE: String

location-name

the location name (CANDIDATE)

TYPE: String

lata

Local Access Transport Area (1920s) (CANDIDATE)

TYPE: String

ctag-pools

CE VLAN IDs

TYPE: Array

Latitude Uncertainty

When the Ver field = 1, this field represents latitude uncertainty. Uncertainty = 2 ^ ( 21 - x ). x = 21 - ceil( log2( uncertainty ) )

TYPE: String

Longitude Uncertainty

When the Ver field = 1, this field represents longitude uncertainty. Uncertainty = 2 ^ ( 21 - x ). x = 21 - ceil( log2( uncertainty ) )

TYPE: String

Altitude Uncertainy

When the Ver field = 1, this field represents altitude uncertainty.

TYPE: String

Altitude Type

(1) Altitude in Meters, (2) Altitude in Floors.

TYPE: String

Altitute Resolution

value encodes the number of high-order altitude bits that should be considered valid

TYPE: String

Map Datum

The Map Datum used for the coordinates given in this option: WGS84, NAD83 + NAVD88, NAD83 + MLLW.

TYPE: String


Relationships

Relationships: Describe how this Information Element is related to other Information Elements. Also describe nature of the relationship: association, inheritance, dependency, etc. and multiplicity.

  *** NOT SURE HOW TO FILL OUT ***

Originator

DESIGN TIME - services are declared with resources (xNFs). xNFs would associate with PLACE information. Cells (logical objects) in C&PS DB would associate with the PLACE information.

RUN TIME - xNFs are instantiated. PNF register. At the point of registration PLACE information is set.

RUN TIME - OOF SON PCI - Logical objects, cells associated with the PNF will set PLACE information.

Consumers

PNF Plug and Play Use Case (Inside ONAP) - The Plug and Play use case describes the process that a PNF performs when it tries to register with ONAP. This means that during installation & commissioning, ONAP needs to set the PNF Place information. This would likely not be reported by the PNF itself, but would be cross-correlated with the PNF resource instantiation during SO BPMN/WF/BB execution.

OOF SON PCI Use Case (Inside ONAP) - The OOF SON PCI Use Case is an existing Use Case that was started in R3 Casablanca. It has continued to develop throughout R4, R5 and R6. This Use Case is all about PCI location and cell location. Which requires location and place information to be associated with the cell logical object.

External Apps tracking location (Outside of ONAP to External APIs).

Who uses this information inside & outside of ONAP?  How do they use it?

Includes description of information consumed (whole class, specific attributes, etc.)

Producers

PNF Plug and Play Use Case (Inside ONAP) - This would likely be updated during PnP registration for the PNF resource instantiation during SO BPMN/WF/BB execution.

OOF SON PCI Use Case (Inside ONAP) - This information is updated when the PCI micro-service excutes. It needs to know about neighbors and cell locations. When setting up its data it needs to know the relatively location of cells.

Who updates this information inside & outside of ONAP? Under what conditions do they update it?

Includes description of information produced (whole class, specific attributes, etc.)

Steward

PNF Plug and Play Use Case (Inside ONAP) - The geolocation information should be captured in an instantiation of the PLACE object. The PNF instance should associated with this object.

OOF SON PCI Use Case (Inside ONAP) - The geolocation information should be captured in an instantiation of the PLACE object. The PNF instance should associated with this object.

Where will this information stored and maintained in ONAP?

Impacted APIs & Schemas

PNF Plug and Play Use Case (Inside ONAP) - The SO API for BB should be impacted.

OOF SON PCI Use Case (Inside ONAP) - The C&PS API will be impacted, which is where the PCI Use Case stores informaiton

Identify impacted ONAP schemas & APIs

Are there existing schemas be used or extended?

Information Modeling Status

This is scheduled in the R7 Modeling planning page. The Wiki page: ONAP R7 Modeling High Level Requirements

It is being tracked by the Modeling-368 Jira which can be found here:

Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyMODELING-368

What is the status of ONAP Information Modeling activities associated with this Information Element.

Please provide links to relevant wiki pages & JIRA.

Schema Definition Status

What is the status of ONAP Schema Definition activities associated with this Information Element.

Please provide links to relevant wiki pages & JIRA.

ONAP Release Priority

R6 Frankfurt - Experimental model introduction of Place Object was introduced by Kevin Scaggs

R7 Guilin - Model introduction of Place used by OOF SON PCI U/Cshould be developed.