X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Fapi-docs.rst;h=8736a6368b13e2b877d660592f5d1027503e9703;hb=d3920fdf9938291fcd01388deea763d097b0d6c8;hp=a2964601d0f7e8f7572fcceb383306da50479a66;hpb=e6b4d27d99570c34271d3176c6969bc5bc46a039;p=nonrtric.git diff --git a/docs/api-docs.rst b/docs/api-docs.rst index a2964601..8736a636 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,40 +12,39 @@ This is the API-docs of Non-RT RIC. :depth: 3 :local: -API Introduction ------------------ - -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. +The Non-RT RIC consists of two parts, described in the sections below: + * The Policy Agent + * The SDNC A1 Controller -API Functions -------------- - -To run the dashboard locally, you can follow these steps: +Policy Agent +============ -- Fetch the latest code from `gerrit`_ +The Policy Agent provides common functionality useful for R-Apps, for instance: + * A repository of available Near-RT RICs, their policy types and policy instances. + * An A1 connection to the Near-RT RICs. -.. _gerrit: https://gerrit.nordix.org/c/oransc/nonrtric/+/2747/ +See :ref:`policy-agent-api` for how to use the API. -- Before compiling, run the following commands:: +See the README.md file in the nonrtric/policy-agent repo for info about how to use it. - git submodule init - - git submodule update - -- Start the backend (you might have to build it first):: - - mvn clean install +API Functions +------------- +See the following document for the Policy Agent API: nonrtric/policy-agent/docs/api.yaml - mvn -Dorg.oransc.ric.portal.dashboard=mock -Dtest=DashboardTestServer -DfailIfNoTests=false test +SDNC A1 Controller +================== +An ONAP SDNC Controller for the A1 interface. -- Now you can open URL: `localhost:8080`_ in a browser. +See the README.md file in the nonrtric/sdnc-a1-controller repo for info about how to use it. -.. _localhost:8080: localhost:8080 +Complementary tools +=================== -From the main page, click on the "Policy Control" card. From here, it is possible to create or list instances for each existing policy type. +There are two additional tools that can be used together with the Non-RT RIC, namely the control panel and the Near-RT RIC simulator. -When the instances are listed, it is possible to edit or delete each instance from the expanded view. +The Non-RT RIC Control panel provides a user interface that allows the user to interact with the Non-RT RIC. +It can be downloaded using: git clone "https://gerrit.o-ran-sc.org/r/portal/nonrtric-controlpanel" -.. image:: ./images/non-RT_RIC_dashboard.png \ No newline at end of file +The Near-RT RIC simulator does what its name suggests, and can be downloaded here: git clone "https://gerrit.o-ran-sc.org/r/sim/a1-interface"