Skip to content

Latest commit

 

History

History
127 lines (89 loc) · 7.53 KB

README.md

File metadata and controls

127 lines (89 loc) · 7.53 KB

Build Status Join the chat at https://gitter.im/sonata-nfv/

5GTango Network Slice Manager (tng-slice-mngr)

  • Description: 5GTANGO Service Platform Slice Manager
  • Version: 2.0
  • Actions:
    • Network Slice Template Management (create, check, update, delete).
    • Network Slice Instantiation Management (create/instantiate, check, update, terminate, delete).

Network Slice Theory

A Network Slice Instance (NSI) is defined in by Mschner K. et all Hedmar, P. in Description of network slicing concept. (NGMN Alliance document, January 2016) as a set of network functions and the resources for these network functions which are arranged and configured, forming a complete logical network, which meets certain characteristics in terms of available bandwidth, latency, or QoS, among others described in 5QI (5G QoS Indicator). Our component follows ETSI EVE 012 approach to combine 3GPP Network Slices and ETSI NFV network services. More information is provided at the wiki.

  • Features:
    • Network Slice Service Composition: link all the Networks Services within a Netwrok Slice
    • Network Slice Service Sharing: Share Network Services among Network Slices
    • Single-VIM Deployment: all Network Services composing a Network Slice are instantiated in one VIM.

Installing / Getting Started

It is strongly recommended to install this component with the whole SONATA SP. In order to install this component, please follow the procedure described in the official 5GTango Documentation webpage.

To use the SONATA Network Slice Manager feature, there are two possible options:

INFORMATION NOTE: Once installed (together with the SP modules) and before using it, if you are new on the Network Slicing "world", please check the information about the available functionalities accessing the tng-slice-mngr wiki page.

If you still want to to install this component alone, just run the following command:

python setup.py install

once installed, to start the component:

python3 main.py

In order to start using this component, please reffer to the previous quickguide link.

Developing

To contribute to the development of this 5GTANGO component, you may use the very same development workflow as for any other 5GTANGO Github project:

  1. you have to fork the repository and create pull requests.
  2. you pull requests will be verified and merged once a reviewer accepts it.

Component Design

In order to contribute to this component, please be aware about its internal archtiecture:

This component is design with two main components:

  • Slice Lifecycle Manager: It is the responsible for the entire lifecycle management of the created network slice instance, until it is terminated. Subsequent lifecycle events are likely to have an impact on the lifecycle of the underlying NSs, but not systematically. The Slice Lifecycle Manager function is responsible for the definition and update of Network Slice Templates (NST).

  • Slice2NS Mapper: This component has to maintain an association between NST and NSDs identifiers, as well as an association between slice identifiers and NS instance identifiers. Slice2NS Mapper is responsible for interacting with SP MANO Framework.

Built With

As the SONATA Service Platform is composed by multiple modules and all of them using Dockers, the 5GTANGO Network Slice Manager environment and its dependencies are already installed within the Docker. This component uses the following dependencies:

  • Flask (0.12.2)
  • flask-restful
  • python-dateutil
  • python-uuid
  • requests
  • xmlrunner (1.7.7)

INFORMATION NOTE: these are minimum versions, it is not tested with the newest versions probably they should be fine. If there's no specific version, the newest versions should work fine but it is not tested.

Prerequisits, Setting up Dev, Building and Deploying / Publishing

In order to have a full functionality, it is necessary to install the all the SONATA SP modules, further information in the 5GTango Documentation webpage.

Versioning

This is the V2.0 of this component, which is part of SONATA SP 5.0 (developed by the EU 5GTango project)

Configuration

No configuration is necessary, as the port where this component listens (5998) is already defined and agreed with the other SONATA SP components.

Tests

Please use the tests in tng-tests

API Reference

Each SONATA component has its API definition, the next sub-setions present a basic tng-slice-mngr API information. Further information about the 5GTANGO software, click in the Global SONATA API Webpage.

Network Slice Template APIs

Available OpenAPI description: slice-mngr_NST.json

Action HTTP method Endpoint
CREATE NST POST /api/nst/v1/descriptors
GET ALL NST GET /api/nst/v1/descriptors
GET SPECIFIC NST GET /api/nst/v1/descriptors/{nst_uuid}
DELETE NST DELETE /api/nst/v1/descriptors/{nst_uuid}

Network Slice Instance APIs

Available OpenAPI description: slice-mngr_NSI.json

Action HTTP method Endpoint
CREATE/INSTANTIATE NSI POST /api/nsilcm/v1/nsi
GET ALL NSIs GET /api/nsilcm/v1/nsi
GET SPECIFIC NSI GET /api/nsilcm/v1/nsi/{nsi_uuid}
TERMINATE NSI POST /api/nsilcm/v1/nsi/{nsi_uuid}/terminate
DELETE NSI DELETE /api/nsilcm/v1/nsi/{nsi_uuid}

Database

This component uses the tng-cat and tng-rep as its database references. By using them, the Network Slice mManager data objects are kept in databases managed by thes two components.

Licensing

This 5GTANGO component is published under Apache 2.0 license. Please see the LICENSE file for more details.

Lead Developers

The following lead developers are responsible for this repository and have admin rights. They can, for example, merge pull requests.

Reviewers:

Feedback-Channel