From e46bb690d572208c76197b877b77c39d84a2f5ee Mon Sep 17 00:00:00 2001 From: elinuxhenrik Date: Wed, 26 May 2021 14:37:53 +0200 Subject: [PATCH] Improve documentation Isue-ID: NONRTRIC-507 Signed-off-by: elinuxhenrik Change-Id: Iedc43939832dfe4a6d2a413955058e7388b319cd --- docs/developer-guide.rst | 72 +++++++++++++-------- docs/images/non-RT_RIC_controlpanel_ric_config.PNG | Bin 0 -> 50941 bytes docs/overview.rst | 16 +++-- 3 files changed, 56 insertions(+), 32 deletions(-) create mode 100644 docs/images/non-RT_RIC_controlpanel_ric_config.PNG diff --git a/docs/developer-guide.rst b/docs/developer-guide.rst index 5804f23..ca42ed3 100644 --- a/docs/developer-guide.rst +++ b/docs/developer-guide.rst @@ -8,59 +8,79 @@ Developer Guide This document provides a quickstart for developers of the Non-RT RIC Control Panel. The Non-RT RIC Control Panel is an interface that allows human users to create, edit and delete policy instances, for -each existing policy type. The policy types and their definitions are retrieved from each Near-RT RIC. +each existing policy type. The policy types and their definitions are retrieved from each Near-RT RIC. It is also +possible to change the configuration of available RICs, provided that Consul is not used. -Additionally, producers and jobs for the Enrichment Information coordinator service can be viewed and managed. +Additionally, producers and jobs for the Enrichment Information coordinator service can be viewed. See the README.md file in the nonrtric-controlpanel repo for information about how to use it. Start the Control Panel for development --------------------------------------- -To run the Control Panel locally for development with simulated services, follow these steps: +To run the Control Panel locally for development , follow the steps below. -- Fetch the latest code from `gerrit`_ +First, fetch the latest code from `gerrit `_ and +go in to the frontend folder in the repo: -.. _gerrit: https://gerrit.o-ran-sc.org/r/admin/repos/portal/nonrtric-controlpanel -- Start the frontend: + +----------------------------------------------------+ + | cd nonrtric-controlpanel/webapp-frontend | + +----------------------------------------------------+ - +------------------------------+ - | cd webapp-frontend | - +------------------------------+ +The Control Panel can be started with mock data to make it easy to develop the GUI without the need to start all services. +Run the following command to start with mock data: - - To start the frontend with Mock data: + +------------------------------+ + | npm run start:mock | + +------------------------------+ - +------------------------------+ - | npm run start:mock | - +------------------------------+ +To start the frontend to get real information from Non-RT RIC services the following services need to be started first: - - To start the UI: +- ControlPanel API Gateway +- Policy Management Service, +- EI Service. - - You need to start the ControlPanel API Gateway, Policy Management Service & EI Service for the UI to list policy & EI information +By pulling the `nonrtric `__ repo and using the script +"PM_EI_DEMO.sh" in the folder "test/autotest", the above services will be started and populated with data. It requires +Docker to run. To run this script with a local version of the Control Panel, a docker image of the Control Panel must +first be created. To do this, run the following command: - +---------------------------------------------------+ - | ./ng serve --proxy-config proxy.conf.json | - +---------------------------------------------------+ + +-------------------------------------------------------------------+ + | docker build -t o-ran-sc/nonrtric-controlpanel:2.2.0-SNAPSHOT . | + +-------------------------------------------------------------------+ - OR +Then run the following command to start the script with the local image: - +---------------------+ - | npm start | - +---------------------+ + +-------------------------------------------------------------------------------------------------------------------+ + | sudo ./PM_EI_DEMO.sh remote-remove docker --env-file ../common/test_env-oran-d-release.sh --use-local-image CP | + +-------------------------------------------------------------------------------------------------------------------+ - - Now you can open URL: `localhost:4200`_ in a browser to access the Control Panel. +When the above servers are started and populated with data, run the following command: + + +---------------------+ + | npm start | + +---------------------+ + +Open the URL: `localhost:4200`_ in a browser to access the Control Panel. .. _localhost:4200: http://localhost:4200 -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. +From the main page, click on the "Policy Control" card or use the menu on the left hand side of the page. From here, it +is possible to create or list instances for each existing policy type. When the instances are listed, it is possible to edit or delete each instance from the expanded view. .. image:: ./images/non-RT_RIC_controlpanel_Policy.PNG -In order to view producers and jobs from the EI service, from the main page, click on the "Enrichment information coordinator" card or use the menu on the left hand side of the page. +It is also possible to manage the configuration of available RICs, provided that Consul is not used, from the Control Panel. +From the menu on the left hand side, select "Policy -> RIC Config". + +.. image:: ./images/non-RT_RIC_controlpanel_ric_config.PNG + + +From the main page, click on the "Enrichment information coordinator" card or use the menu on the left hand side of the page. +From here it is possible to view producers and jobs from the EI service, .. image:: ./images/non-RT_RIC_controlpanel_EI.PNG diff --git a/docs/images/non-RT_RIC_controlpanel_ric_config.PNG b/docs/images/non-RT_RIC_controlpanel_ric_config.PNG new file mode 100644 index 0000000000000000000000000000000000000000..6728a2919ff812e5513bc5bab96fb56eb7840639 GIT binary patch literal 50941 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%0DUa;%|}O!>^Xnm99uGv@hI}7 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