-# kpimon
-KPIMON xApp for Bronze Release
-# Image Build
+==================================================================================
+ Copyright (c) 2020 AT&T Intellectual Property.
-```
-$ docker build . --tag kpimon:{TAG} --no-cache
-```
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+==================================================================================
+
+KPI Monitoring
+================
+
+This repository contains the source for the RIC KPI monitoring application.
+
+This xApp can be onboarded through the xApp Onboarder. The xapp descriptor
+is under the xapp-descriptor/ directory.
+
+Then the xapp can be deployed through the App Manager.
--- /dev/null
+from docs_conf.conf import *
+
+linkcheck_ignore = ["http://localhost.*", "http://127.0.0.1.*", "https://gerrit.o-ran-sc.org.*"]
--- /dev/null
+---
+project_cfg: oran
+project: ric-app-kpimon
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2020 AT&T Intellectual Property
+
+
+Developers Guide
+=================
+
+.. contents::
+ :depth: 3
+ :local:
+
+
+Version bumping the Xapp
+------------------------
+
+This project follows semver. When changes are made, update the version strings in:
+
+#. ``container-tag.yaml``
+#. ``docs/release-notes.rst``
+#. ``setup.py``
+#. ``xapp-descriptor/config.json``
+
+
+Testing RMR Healthcheck
+-----------------------
+The following instructions should deploy the QP Driver container in bare docker, and allow you
+to test that the RMR healthcheck is working.
+
+::
+
+ docker build -t qpd:latest -f Dockerfile .
+ docker run -d --net=host -e USE_FAKE_SDL=1 qpd:latest
+ docker exec -it CONTAINER_ID /usr/local/bin/rmr_probe -h 127.0.0.1:4560
+
+
+Unit Testing
+------------
+
+Running the unit tests requires the python packages ``tox`` and ``pytest``.
+
+The RMR library is also required during unit tests. If running directly from tox
+(outside a Docker container), install RMR according to its instructions.
+
+Upon completion, view the test coverage like this:
+
+::
+
+ tox
+ open htmlcov/index.html
+
+Alternatively, if you cannot install RMR locally, you can run the unit
+tests in Docker. This is somewhat less nice because you don't get the
+pretty HTML report on coverage.
+
+::
+
+ docker build --no-cache -f Dockerfile-Unit-Test .
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2020 AT&T Intellectual Property
+
+
+Welcome to O-RAN SC qp-driver Documentation
+============================================
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Contents:
+
+ overview.rst
+ release-notes.rst
+ installation-guide.rst
+ developers-guide.rst
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2020 AT&T Intellectual Property
+
+
+Installation Guide
+==================
+
+.. contents::
+ :depth: 3
+ :local:
+
+Installation
+------------
+
+[to come]
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2020 AT&T Intellectual Property
+
+KPIMON Overview
+==================
+
+KPIMON is an Xapp in the traffic steering O-RAN use case.
+There are four total Xapps:
+
+1. Traffic steering, which sends "prediction requests" to QP Driver
+
+2. QP Driver which fetches data from SDL[4] on behalf of traffic steering, both UE Data and Cell Data, merges that data together, then sends off the data to the QP Predictor
+
+3. QP Predictor which predicts and sends that prediction back to Traffic Steering
+
+4. KPIMONN which collects UE/Cell metrics from base station and populates SDL in the first place (this)
+
+So in summary, the KPIMON xapp is a helper function that receives RAN metrics and write to SDL
--- /dev/null
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. SPDX-License-Identifier: CC-BY-4.0
+.. Copyright (C) 2020 AT&T Intellectual Property
+
+Release Notes
+===============
+
+All notable changes to this project will be documented in this file.
+
+The format is based on `Keep a Changelog <http://keepachangelog.com/>`__
+and this project adheres to `Semantic Versioning <http://semver.org/>`__.
+
+
+[1.0.1] - 1/20/2021
+--------------------
+
+* Use SDL lib to replace direct use of Redis client
+* Add xapp descriptor
+
+
+[1.0.0] - 12/16/2020
+--------------------
+
+* Update builder image
+* Change key name
+
+
+[0.4.0] - 11/27/2020
+------------------
+
+* Fix RIC_INDICATION RANContainer decoding issue
+* Fix data format issue when storing data into DB
+
+
+[0.3.0] - 10/16/2020
+------------------
+
+* Fix interface type issue when decoding RIC_INDICATION
+* Integration test with e2sim
+
+
+[0.2.0] - 7/17/2020
+------------------
+
+* CI config
+* Add memory free function for E2AP/E2SM encoding and decoding
+* Log output
+* Code optimization
+
+
+[0.1.0] - 4/21/2020
+-------------------
+
+* RIC_INDICATION
+* Store UE/Cell metrics into Redis DB
+* Small cleanups
+
+
+[0.0.2] - 3/25/2020
+-------------------
+
+* RIC_SUB_REQ
+* Helm chart
+* Dockerfile
+
+
+[0.0.1] - 3/10/2020
+-------------------
+
+* inital skeleton creation
--- /dev/null
+sphinx
+sphinx-rtd-theme
+sphinxcontrib-httpdomain
+recommonmark
+lfdocs-conf
Code Review / scp / ric-app / kpimon.git / commitdiff
