From 0c44286e7848e34aeabe458e1fef7f0b24e78f0c Mon Sep 17 00:00:00 2001 From: elinuxhenrik Date: Fri, 31 Jan 2020 11:27:50 +0100 Subject: [PATCH] Update the documentation Change-Id: Ib9249965dc324cf97c454f1f8c86e13c5aa5ded4 Signed-off-by: elinuxhenrik --- docs/api-docs.rst | 44 ++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 40 insertions(+), 4 deletions(-) diff --git a/docs/api-docs.rst b/docs/api-docs.rst index 193a8281..cf3fa6e0 100644 --- a/docs/api-docs.rst +++ b/docs/api-docs.rst @@ -2,7 +2,7 @@ .. http://creativecommons.org/licenses/by/4.0 - +======== API-Docs ======== @@ -12,11 +12,18 @@ This is the API-docs of Non-RT RIC. :depth: 3 :local: -API Introduction ------------------ +The Non-RT RIC consists of four parts, described in the sections below: + * The Dashboard + * The Policy Agent + * The Near-RT RIC simulator + * The Sdnc A1 Controller + +Dashboard +========= The Non-RT RIC dashboard is an interface that allows human users to create, edit and delete policy instances, for each existing policy type. The policy types are owned by the Near-RT RIC, Non-RT RIC can just query them, so it's not possible to act on them. +See the README.md file in the nonrtric/dashboard repo for info about how to use it. API Functions ------------- @@ -48,4 +55,33 @@ From the main page, click on the "Policy Control" card. From here, it is possibl When the instances are listed, it is possible to edit or delete each instance from the expanded view. -.. image:: ./images/non-RT_RIC_dashboard.png \ No newline at end of file +.. image:: ./images/non-RT_RIC_dashboard.png + +Policy Agent +============ +The Policy Agent provides common functionality useful for R-Apps, for instance: + * A repository of available Near-T RICs, their policy types and policy instances. + * An A1 connection to he Near-RT RICs. + +See the README.md file in the nonrtric/policy-agent repo for info about how to use it. + +API Functins +------------ +See the following document for the Policy Agent API: nonrtric/policy-agent/docs/api.doc. + +Near-RT RIC Simulator +===================== +A simulator that simulates a Neat-RT RIC, with a termination of the A1 interface. It also provides an administrative API to manage types and instances so it can be programatically set up for use in tests. + +See the README.md file in the nonrtric/near-rt-ric-simulator repo for info about how to use it. + +API Functions +------------- +See the admnistrative API in: nonrtric/near-rt-ric-simulator/ric-plt/a1/main.py. + +Sdnc A1 Controller +================== +An ONAP SDNC Controller for the A1 interface. + +See the README.md file in the nonrtric/sdnc-a1-controller repo for info about how to use it. + -- 2.16.6