aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorDongho Kim <dk5913@att.com>2020-04-09 10:52:13 -0700
committerMorgan Richomme <morgan.richomme@orange.com>2020-04-10 16:12:26 +0000
commit287b75a69965d90e56dee2e6006fde931f9942d6 (patch)
tree8bd0403f7d7769fb6703a7c3a274d172a0b662a5 /docs
parent25ce8bbd340164c03235bd21b9496d8b860c40ad (diff)
Update A1 Adaptor section to user guide
Change-Id: I6b1d1173bcb2c9e190584445fde561b204e8664c Signed-off-by: Dongho Kim <dk5913@att.com> Issue-ID: INT-1503
Diffstat (limited to 'docs')
-rw-r--r--docs/docs_5g_a1_adaptor.rst54
-rw-r--r--docs/docs_usecases.rst2
2 files changed, 56 insertions, 0 deletions
diff --git a/docs/docs_5g_a1_adaptor.rst b/docs/docs_5g_a1_adaptor.rst
new file mode 100644
index 000000000..18e165e65
--- /dev/null
+++ b/docs/docs_5g_a1_adaptor.rst
@@ -0,0 +1,54 @@
+.. This work is licensed under a Creative Commons Attribution 4.0
+ International License. http://creativecommons.org/licenses/by/4.0
+
+.. _docs_5g_a1_adaptor:
+
+5G - A1 Adaptor
+---------------
+
+Description
+~~~~~~~~~~~
+
+A1 is an O-RAN defined interface between Non-Real Time RIC (Ran Intelligent Controller) in the management platform (ONAP) and RAN network element called Near-Real Time RIC.
+A1 interface is used to communicate policy choices, AI/ML model updates, and other RAN functions that are not included in the traditional network configuration.
+O-RAN defines architecture of RT RIC and relevant interfaces.
+O-RAN WG2 has released the first version of A1 specifications September 2019.
+ONAP needed to implement a module serving a communication channel between other ONAP components and RT RIC for A1 interface.
+ONAP community has a harmonization project with mobility standard and A1 adaptor has been proposed in the project (https://wiki.onap.org/display/DW/MOBILITY+STANDARDS+HARMONIZATION+WITH+ONAP).
+A1 adaptor has been implemented as a component in CCSDK. All implementation details are explained here: https://wiki.onap.org/display/DW/A1+Adapter+in+ONAP
+
+How to Use
+~~~~~~~~~~
+
+Following steps describe a general procedure about how to use A1 adaptor.
+
+1. ONAP Frankfurt includes A1 adaptor.
+
+2. Edit A1 adaptor property file in sdnc container at dev-sdnc-x POD. (dev is an example of release name and x is replica number)
+
+ a. A property file is located at /opt/onap/ccsdk/data/properties/a1-adapter-api-dg.properties.
+
+ b. SSH into a rancher node (NFS/rancher).
+
+ c. sudo su
+
+ d. kubectl get pods -n onap -o wide | grep sdnc
+
+ e. execute the following command to all sdnc PODs to update properties files.
+
+ - kubectl exec -it dev-sdnc-x bash (x=0,1,2, depending on number of sdnc replicas in the setup)
+
+ f. Once in the docker, edit the properties file.
+
+ g. Make following configuration changes per setup
+
+ - Update IP address and port number for Near-Real Time RIC as below
+
+ - near-rt-ric-id=a.b.c.d:port
+
+A1 adaptor has been tested with A1 mediator as an example of Near-Real Time RIC. Detailed information can be found at its repo: https://gerrit.o-ran-sc.org/r/gitweb?p=ric-plt%2Fric-dep.git;a=shortlog;h=refs%2Fheads%2Fmaster.
+
+Test Status and Plans
+~~~~~~~~~~~~~~~~~~~~~
+
+For ONAP Frankfurt, A1 adaptor has not been involved in a full closed loop use case. A1 adaptor has gone through a unit test with A1 mediator in OSC as a underlying device. It has been tested for receiving A1 policy via DMaaP and publishing a response back to DMaaP as well as notification. More details are presented in https://wiki.onap.org/pages/viewpage.action?pageId=71837463.
diff --git a/docs/docs_usecases.rst b/docs/docs_usecases.rst
index e7f188581..4dfd75b96 100644
--- a/docs/docs_usecases.rst
+++ b/docs/docs_usecases.rst
@@ -51,6 +51,8 @@ Functional Requirements
:ref:`5G - NRM Configuration <docs_5G_NRM_Configuration>`
+:ref:`5G - A1 Adaptor <docs_5g_a1_adaptor>`
+
:ref:`PNF Support - PNF Plug and Play <docs_5g_pnf_pnp>`
:ref:`PNF Support - PNF Software Upgrade <docs_5g_pnf_software_upgrade>`