From ea2fcc88ac18dc3da0de191645688ab7829db0c4 Mon Sep 17 00:00:00 2001 From: elinuxhenrik Date: Tue, 13 Oct 2020 16:39:13 +0200 Subject: Add A1 Adapter API documentation Change-Id: Id19e858c67681b781871169ef79da5edf48c5cb2 Issue-ID: CCSDK-2833 Signed-off-by: elinuxhenrik --- docs/guide/developer-guide.rst | 30 ++++++++++++++++++------------ 1 file changed, 18 insertions(+), 12 deletions(-) (limited to 'docs/guide') diff --git a/docs/guide/developer-guide.rst b/docs/guide/developer-guide.rst index b6d4ce88..f067a3fa 100644 --- a/docs/guide/developer-guide.rst +++ b/docs/guide/developer-guide.rst @@ -36,6 +36,7 @@ The Policy Management Service can be accessed over the REST API. See :ref:`pms_a Dependencies ------------ + This project uses various frameworks which are managed with Maven dependency management tool (see *pom.xml* file at root level) : @@ -59,16 +60,21 @@ that are available. The second contains logging and security configurations. Configuration of certs ---------------------- -The Policy Management Service uses the default keystore and truststore that are built into the container. The paths and passwords for these stores are located in a yaml file: - oran/a1-policy-management/config/application.yaml +The Policy Management Service uses the default keystore and truststore that are built into the container. The paths and +passwords for these stores are located in a yaml file: :: + + oran/a1-policy-management/config/application.yaml -There is also Policy Management Service's own cert in the default truststore for mocking purposes and unit-testing (ApplicationTest.java). +There is also Policy Management Service's own cert in the default truststore for mocking purposes and unit-testing +(ApplicationTest.java). -The default keystore, truststore, and application.yaml files can be overridden by mounting new files using the "volumes" field of docker-compose or docker run command. +The default keystore, truststore, and application.yaml files can be overridden by mounting new files using the "volumes" +field of docker-compose or docker run command. -Assuming that the keystore, truststore, and application.yaml files are located in the same directory as docker-compose, the volumes field should have these entries: +Assuming that the keystore, truststore, and application.yaml files are located in the same directory as docker-compose, +the volumes field should have these entries: :: -`volumes:` + `volumes:` `- ./new_keystore.jks:/opt/app/policy-agent/etc/cert/keystore.jks:ro` `- ./new_truststore.jks:/opt/app/policy-agent/etc/cert/truststore.jks:ro` @@ -77,13 +83,13 @@ Assuming that the keystore, truststore, and application.yaml files are located i The target paths in the container should not be modified. -Example docker run command for mounting new files (assuming they are located in the current directory): +Example docker run command for mounting new files (assuming they are located in the current directory): :: -`docker run -p 8081:8081 -p 8433:8433 --name=policy-agent-container --network=nonrtric-docker-net --volume "$PWD/new_keystore.jks:/opt/app/policy-agent/etc/cert/keystore.jks" --volume "$PWD/new_truststore.jks:/opt/app/policy-agent/etc/cert/truststore.jks" --volume "$PWD/new_application.yaml:/opt/app/policy-agent/config/application.yaml" o-ran-sc/nonrtric-policy-agent:2.1.0-SNAPSHOT` + docker run -p 8081:8081 -p 8433:8433 --name=policy-agent-container --network=nonrtric-docker-net --volume "$PWD/new_keystore.jks:/opt/app/policy-agent/etc/cert/keystore.jks" --volume "$PWD/new_truststore.jks:/opt/app/policy-agent/etc/cert/truststore.jks" --volume "$PWD/new_application.yaml:/opt/app/policy-agent/config/application.yaml" o-ran-sc/nonrtric-policy-agent:2.1.0-SNAPSHOT -A1 Adapter -++++++++++ +A1 Adapter (Internal) ++++++++++++++++++++++ -TBD +The O-RAN A1 Adapter provides an internal REST CONF API for management of A1 policices, useful for test and verification. -The A1 Adapter can be accessed over the REST API. See :ref:`offered_apis` for how to use the API. +The A1 Adapter can be accessed over the REST CONF API. See :ref:`a1_adapter_api` for how to use the API. -- cgit 1.2.3-korg