From d3eb0509dbf893a42d01202334aa18fbc2461a8e Mon Sep 17 00:00:00 2001 From: Reshmasree Date: Tue, 26 May 2020 08:02:59 +0000 Subject: Update OOF_SON use case documentation Issue-ID: INT-1466 Signed-off-by: Reshmasree Change-Id: Ice7f111378b1c020a3367be1b5d8b5f812d9c79a Signed-off-by: mrichomme (cherry picked from commit c27b77fcd8dff92d9b891c75bff3267931cec35a) --- docs/docs_5G_oof_pci.rst | 65 ++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 54 insertions(+), 11 deletions(-) diff --git a/docs/docs_5G_oof_pci.rst b/docs/docs_5G_oof_pci.rst index 04254bc53..3fbeffe46 100644 --- a/docs/docs_5G_oof_pci.rst +++ b/docs/docs_5G_oof_pci.rst @@ -1,73 +1,116 @@ .. This work is licensed under a Creative Commons Attribution 4.0 + International License. http://creativecommons.org/licenses/by/4.0 + .. contents:: + :depth: 3 + .. + .. _docs_5G_oof_pci: + OOF-PCI -------- + Description ~~~~~~~~~~~ + The 5G OOF-PCI use case is an implementation of a SON (Self-Organizing Networks) algorithm + for Physical Cell ID (PCI) optimization and the centralized Automatic Neighbor Relations + (ANR) function (blacklisting a neighbor for handovers) in a 4G/5G network using the ONAP + Optimization Framework (OOF). This use case began with the implementation of PCI + optimization in Casablanca. In Dublin release, the SON-Handler MS was onboarded asa + micro-service in DCAE. Enhancements were made to Policy and SDN-C components. Further + details of Dublin release scope and impacts for this use case are described in: + https://docs.onap.org/en/dublin/submodules/integration.git/docs/docs_5G_oof_pci.html#docs-5g-oof-pci -In Frankfurt release, the following are the main enhancements: -- Introduction of Control Loop Coordination functionality, wherein a second control loop execution is denied by Policy component when another control loop is in progress. +In Frankfurt release, the following are the main enhancements: -- Introduction of adaptive SON, wherein a set of cells whose PCI values are fixed (i.e., cannot be changed during PCI optimization) are considered during the PCI optimization. +- Introduction of Control Loop Coordination functionality, wherein a second control loop execution is + denied by Policy component when another control loop is in progress. +- Introduction of adaptive SON, wherein a set of cells whose PCI values are fixed (i.e., cannot be changed + during PCI optimization) are considered during the PCI optimization. +- In addition, the first step towards O-RAN alignment is being taken with SDN-C (R) being able to receive a DMaaP + message containing configuration updates (which would be triggered when a neighbor-list-change occurs in the RAN + and is communicated to ONAP over VES). -- In addition, the first step towards O-RAN alignment is being taken with SDN-C (R) being able to receive a DMaaP message containing configuration updates (which would be triggered when a neighbor-list-change occurs in the RAN and is communicated to ONAP over VES). As part of this use case work, a RAN Simulator providing a simulated Radio Access Network (RAN) with a number of netconf servers simulating PNF elements has been implemented. The functionality of the RAN Simulator includes: - Generation of neighbor-list-update messages - - Generation of alarms for PCI collision/confusion and - - Generation of handover metrics for different neighbor pairs (for the ANR use case). All above functionality are enabled using a simple UI. All details regarding the use case for Frankfurt can be found here: + https://wiki.onap.org/display/DW/OOF+%28SON%29+in+R5+El+Alto%2C+OOF+%28SON%29+in+R6+Frankfurt -The main use case page is https://wiki.onap.org/display/DW/5G+-+OOF+%28ONAP+Optimization+Framework%29+and+PCI+%28Physical+Cell+ID%29+Optimization +The main use case page is: + +https://wiki.onap.org/display/DW/5G+-+OOF+%28ONAP+Optimization+Framework%29+and+PCI+%28Physical+Cell+ID%29+Optimization How to Use ~~~~~~~~~~ + The OOF-PCI use case is implemented in the Rutgers University (Winlab) ONAP Wireless Lab (OWL). + For details, please see: https://wiki.onap.org/pages/viewpage.action?pageId=45298557. + This page includes instructions for access to the lab. Setup and testing is done manually up to now. For all instructions about installing the components, please see: -Installation - https://wiki.onap.org/display/DW/Demo+setup+steps +Installation: https://wiki.onap.org/display/DW/Demo+setup+steps + -Son-handler installation - https://onap.readthedocs.io/en/latest/submodules/dcaegen2.git/docs/sections/services/son-handler/installation.html +Son-Handler installation: + +https://onap.readthedocs.io/en/latest/submodules/dcaegen2.git/docs/sections/services/son-handler/installation.html Test Status and Plans ~~~~~~~~~~~~~~~~~~~~~ + For Frankfurt release, the enhancements described above were implemented. OOF was enhanced + with handling cells with fixed PCI values during the optimization, SON-Handler MS was + functionally enhanced for adaptive SON functionality, SDN-C (R) was enhanced to include + handling of DMaaP message for config changes in the RAN, and Policy was also enhanced with -Control Loop Co-ordination function. To see information about test plans, please see https://wiki.onap.org/display/DW/Testing. + +Control Loop Co-ordination function. + +To see information about test plans, please see https://wiki.onap.org/display/DW/Testing. Known Issues and Resolutions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -It is intended to have the RAN Simulator support sufficient Honeycomb netconf server instances to simulate 2000 cells. However, this number may be lower if there are hardware limitatons. + +(a) It is intended to have the RAN Simulator support sufficient Honeycomb netconf server instances to simulate 2000 cells. + However, this number may be lower if there are hardware limitatons. +(b) For Control Loop Co-ordination, the denial of a second Control Loop based on Target Lock (i.e., when a second Control + Loop tries to operate on the same target (in this case, a PNF) is successfully tested. The CLC is also applied at Control + Loop level only. However, some code updates are required in Policy to properly update the Operations History DB entry, and + to check the existence of active Control Loops by Policy. This will be addressed in Guilin release, and tracked via + https://jira.onap.org/browse/POLICY-2581 and https://jira.onap.org/browse/POLICY-2583. +(c) For Adaptive SON, the functionality in SON-Handler and OOF is implemented, however the OOF functionality is not + fully tested (this was anyhow a stretch goal). Further, the DCAE-CL-RSP message is not sent by Policy in Frankfurt release. + This is tracked via https://jira.onap.org/browse/POLICY-2580 and shall be part of Guilin release. -- cgit 1.2.3-korg