05cb238395fe457219bb8e1fa098d2c6eb13982d
[dcaegen2.git] / docs / sections / services / slice-analysis-ms / slice_analysis_ms_overview.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0\r
2    International License. http://creativecommons.org/licenses/by/4.0\r
3    \r
4 .. _docs_slice_analysis_ms_overview:\r
5 \r
6 Architecture\r
7 ------------\r
8 The internal architecture of Slice Analysis MS is shown below.\r
9 \r
10 .. image:: ./slice_analysis_ms_arch.jpg\r
11 \r
12 The Slice Analysis MS has a DMaaP interface towards towards Policy and VES-Collector, and a REST\r
13 interface towards Config DB. It also has a DMaaP interface to receive any recommendations for\r
14 Closed Loop updates from an ML engine, which is then used to trigger a control loop message to\r
15 Policy.\r
16 \r
17 - **DMAAP Client** creates a thread pool for every DMaaP topic consumer. The thread\r
18   polls the DMaaP topic for every configured time interval and whenever a message is\r
19   received it stores that message in the Postgres DB.\r
20 \r
21 - **PM Thread** reads the PM event from the database and puts the PM sample in the\r
22   internal queue in the format which is needed for further processing.\r
23 \r
24 - **Consumer Thread** consumes PM samples from the internal queue and make all the\r
25   required Config DB calls, perform the analysis, and puts the onset message to the DMaaP topic.\r
26 \r
27 - **Database** is a PG DB.\r
28 \r
29 Detailed flow diagrams are available at:\r
30 \r
31 Closed Loop: https://wiki.onap.org/display/DW/Closed+Loop\r
32 \r
33 Intelligent Slicing: https://wiki.onap.org/display/DW/Intelligent+Slicing+flow\r
34 \r
35 \r
36 Functional Description\r
37 ----------------------\r
38 - Slice Analysis ms consumes PM messages from PERFORMANCE_MEASUREMENTS topic.\r
39 \r
40 - For analysis Slice Analysis MS consumes various data from Config DB including List of Network  \r
41   Functions which serves the S-NSSAI, List of Near-RT RICs and the corresponding cell mappings of the\r
42   S-NSSAI, Current Configuration of the Near-RT RICs, Slice Profile associated with the S-NSSAI and\r
43   Subscriber details of the S-NSSAI (for sending the onset message to policy).\r
44 \r
45 - Based on the collected PM data, Slice Analysis MS computes the DLThptPerSlice and ULThptPerSlice\r
46   for the Near-RT RICs relevant for the S-NSSAI, and the computed value is compared with the current\r
47   configuration of the Near-RT RICs. If the change in configuration exceeds the minimum percentage\r
48   value which is kept as a configuration parameter, then the closed-loop will be triggered by posting\r
49   the onset message to DMaaP.\r
50 \r
51 - Upon reception of recommendation to update the configuration of RAN from e.g., an ML MS, the Slice\r
52   Analysis MS prepares and sends a control loop onset message.\r
53 \r
54 \r
55 Deployment aspects\r
56 ------------------\r
57 The SON-Handler MS will be deployed on DCAE as an on-demand component. Details of the installation\r
58 steps are available at ./installation.rst. Further details can be obtained from:\r
59 https://wiki.onap.org/pages/viewpage.action?pageId=92998809\r
60 \r
61 \r
62 Known Issues and Resolutions\r
63 ----------------------------\r
64 The assumptions of functionality in Guilin release is documented in:\r
65 https://wiki.onap.org/display/DW/Assumptions+for+Guilin+release\r