X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Fapi-docs.rst;h=9b0608a6c959b42ebd9d66ea1e5b95676f8567b3;hb=9e3bf9348a6f2a739411316591093f3b9a0fc937;hp=cf3fa6e0d80aa7935b4b3e98dcd465e9fa053017;hpb=92b82c1d3f03738395f1489789b0c7908d2076d2;p=nonrtric.git diff --git a/docs/api-docs.rst b/docs/api-docs.rst index cf3fa6e0..9b0608a6 100644 --- a/docs/api-docs.rst +++ b/docs/api-docs.rst @@ -1,5 +1,8 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 +.. Copyright (C) 2020 Nordix + +.. _api_docs: ======== @@ -12,76 +15,69 @@ This is the API-docs of Non-RT RIC. :depth: 3 :local: -The Non-RT RIC consists of four parts, described in the sections below: - * The Dashboard +The Non-RT RIC consists of three parts, described in the sections below: * 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 -------------- + * The SDNC A1 Controller + * The rAPP Catalogue -To run the dashboard locally, you can follow these steps: -- Fetch the latest code from `gerrit`_ +Policy Agent +============ -.. _gerrit: https://gerrit.nordix.org/c/oransc/nonrtric/+/2747/ +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. -- Before compiling, run the following commands:: +See :ref:`policy-agent-api` for how to use the API. - git submodule init +See the README.md file in the nonrtric/policy-agent repo for info about how to use it. - git submodule update +API Functions +------------- +See the following document for the Policy Agent API: nonrtric/policy-agent/docs/api.yaml -- Start the backend (you might have to build it first):: +SDNC A1 Controller +================== - mvn clean install +An ONAP SDNC Controller for the A1 interface. - mvn -Dorg.oransc.ric.portal.dashboard=mock -Dtest=DashboardTestServer -DfailIfNoTests=false test +See :ref:`sdnc-a1-controller-api` for how to use the API. +See the README.md file in the nonrtric/sdnc-a1-controller repo for info about how to use it. -- Now you can open URL: `localhost:8080`_ in a browser. +rAPP Catalogue +============== -.. _localhost:8080: localhost:8080 +The Non RT-RIC Service Catalogue provides a way for services to register themselves for other services to discover. -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. +See `RAC API <./rac-api.html>`_ for how to use the API. -When the instances are listed, it is possible to edit or delete each instance from the expanded view. +.. |swagger-icon| image:: ./images/swagger.png + :width: 40px -.. image:: ./images/non-RT_RIC_dashboard.png +.. |yaml-icon| image:: ./images/yaml_logo.png + :width: 40px -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. +.. csv-table:: + :header: "API name", "|swagger-icon|", "|yaml-icon|" + :widths: 10,5, 5 -API Functins ------------- -See the following document for the Policy Agent API: nonrtric/policy-agent/docs/api.doc. + "RAC API", ":download:`link <../r-app-catalogue/api/rac-api.json>`", ":download:`link <../r-app-catalogue/api/rac-api.yaml>`" -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. +Complementary tools +=================== -See the README.md file in the nonrtric/near-rt-ric-simulator repo for info about how to use it. +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. -API Functions -------------- -See the admnistrative API in: nonrtric/near-rt-ric-simulator/ric-plt/a1/main.py. +The Non-RT RIC Control Panel provides a user interface that allows the user to interact with the Non-RT RIC. +Documentation for the Control Panel can be found here: +:doc:`Non-RT RIC Control Panel `. +It can be downloaded from here: :: -Sdnc A1 Controller -================== -An ONAP SDNC Controller for the A1 interface. + git clone "https://gerrit.o-ran-sc.org/r/portal/nonrtric-controlpanel". -See the README.md file in the nonrtric/sdnc-a1-controller repo for info about how to use it. +The Near-RT RIC simulator simulates an A1 protocol termination endpoint. Documentation for the simulator can be found +here: :doc:`A1 Interface Simulator `. It can be downloaded from here: :: + git clone "https://gerrit.o-ran-sc.org/r/sim/a1-interface"