docs/docs_5G_oof_pci.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0
   2    International License. http://creativecommons.org/licenses/by/4.0
   3
   4 .. _docs_5G_oof_pci:
   5
   6 :orphan:
   7
   8 OOF-PCI
   9 --------
  10
  11 Description
  12 ~~~~~~~~~~~
  13
  14 The 5G OOF-PCI use case is an implementation of a **SON (Self-Organizing Networks)**
  15 algorithm for Physical Cell ID (PCI) optimization and the centralized Automatic Neighbor Relations
  16 (ANR) function (blacklisting a neighbor for handovers) in a 4G/5G network using the ONAP
  17 Optimization Framework (OOF).
  18
  19 The use case is a multi-releases effort initiated in Dublin release.
  20 This use case began with the implementation of PCI optimization in Casablanca.
  21 In Dublin release, the SON-Handler MS was onboarded as a
  22 micro-service in DCAE. Enhancements were made to Policy and SDN-C components.
  23
  24 In Frankfurt release, the following are the main enhancements:
  25
  26 - Introduction of Control Loop Coordination functionality, wherein a second control loop execution is
  27   denied by Policy component when another control loop is in progress.
  28 - Introduction of adaptive SON, wherein a set of cells whose PCI values are fixed (i.e., cannot be changed
  29   during PCI optimization) are considered during the PCI optimization.
  30 - In addition, the first step towards O-RAN alignment is being taken with SDN-C (R) being able to receive a DMaaP
  31   message containing configuration updates (which would be triggered when a neighbor-list-change occurs in the RAN
  32   and is communicated to ONAP over VES). `Details of this implementation <https://wiki.onap.org/display/DW/CM+Notification+Support+in+ONAP>`_
  33
  34 The end-to-end setup for the use case requires a Config DB which stores the cell related details of the RAN.
  35 This is updated by SDN-C (R), and is accessed by SON-Handler MS and OOF for fetching (e.g., neighbor list, PNF id, etc):
  36
  37 - `The Config DB implementation <https://github.com/onap-oof-pci-poc/sdnc/tree/master/ConfigDB/Dublin>`_
  38 - `Swagger JSON API documentation <https://github.com/onap-oof-pci-poc/sdnc/blob/master/ConfigDB/Dublin/SDNC_ConfigDB_API_v3.0.0.json>`_
  39
  40 As part of this use case work, a RAN Simulator providing a simulated Radio Access Network
  41 (RAN) with a number of netconf servers simulating PNF elements has been implemented. The
  42 functionality of the RAN Simulator includes:
  43
  44 - Generation of neighbor-list-update messages
  45 - Generation of alarms for PCI collision/confusion and
  46 - Generation of handover metrics for different neighbor pairs (for the ANR use case).
  47
  48 All above functionality are enabled using a simple UI.
  49
  50 Please see also `OOF (SON) wiki page <https://wiki.onap.org/display/DW/5G+-+OOF+%28ONAP+Optimization+Framework%29+and+PCI+%28Physical+Cell+ID%29+Optimization>`_.
  51 Additional information are available related to previous releases can be found
  52 in `El Alto & Frankfurt OOF (SON) wiki page <https://wiki.onap.org/display/DW/OOF+%28SON%29+in+R5+El+Alto%2C+OOF+%28SON%29+in+R6+Frankfurt>`_.
  53
  54 How to Use
  55 ~~~~~~~~~~
  56
  57 The OOF-PCI use case is implemented in the Rutgers University (Winlab) ONAP Wireless Lab (OWL).
  58 For details, please see
  59 `lab details <https://wiki.onap.org/pages/viewpage.action?pageId=45298557>`_.
  60
  61 This page includes instructions for access to the lab. Setup and testing is done manually up to now.
  62
  63 For all instructions about installing the components, please see:
  64
  65 - `Wiki Installation page <https://wiki.onap.org/display/DW/Demo+setup+steps+for+Frankfurt>`_
  66 - `Son-Handler installation <https://docs.onap.org/projects/onap-dcaegen2/en/frankfurt/sections/services/son-handler/installation.html?highlight=dcaegen2>`_
  67
  68 Test Status and Plans
  69 ~~~~~~~~~~~~~~~~~~~~~
  70
  71 OOF was enhanced with handling cells with fixed PCI values during the optimization,
  72 SON-Handler MS was functionally enhanced for adaptive SON functionality, SDN-C (R)
  73 was enhanced to include handling of DMaaP message for config changes in the RAN,
  74 and Policy was also enhanced with Control Loop Co-ordination function.
  75
  76 See `test plans <https://wiki.onap.org/display/DW/Testing>`_ for details.
  77
  78 Known Issues and Resolutions
  79 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  80
  81 (a) It is intended to have the RAN Simulator support sufficient Honeycomb netconf server instances to simulate 2000 cells.
  82     However, this number may be lower if there are hardware limitations.
  83 (b) For Control Loop Co-ordination, the denial of a second Control Loop based on Target Lock (i.e., when a second Control
  84     Loop tries to operate on the same target (in this case, a PNF) is successfully tested. The CLC is also applied at Control
  85     Loop level only. However, some code updates are required in Policy to properly update the Operations History DB entry, and
  86     to check the existence of active Control Loops by Policy. This will be addressed in Guilin release, and tracked via
  87     https://jira.onap.org/browse/POLICY-2581 and https://jira.onap.org/browse/POLICY-2583.
  88 (c) For Adaptive SON, the functionality in SON-Handler and OOF is implemented, however the OOF functionality is not
  89     fully tested (this was anyhow a stretch goal). Further, the DCAE-CL-RSP message is not sent by Policy in Frankfurt release.
  90     This is tracked via https://jira.onap.org/browse/POLICY-2580 and shall be part of Guilin release.