...

The picture below depicts overall use case flow:

Image RemovedImage Added

3. High-Level Design and Implementation Approach

...

DMAAP Message Request (sent from ONAP or MS components):

DMAAP Message Response (sent from A1 Mediator with status response)

DMAAP message payload is aligned with YANG RPC Input parameters and is exactly the same as, when YANG model RPC input is rendered as a JSON object. See the above example, where DMAAP message is related to RPC "getNearRT-RICs". 

...

6. A1 Mediator References

The A1 Mediator Open API's can be referenced at: https://gerrit.o-ran-sc.org/r/gitweb?p=ric-plt/a1.git;a=history;f=a1/openapi.yaml;h=2aa7a943eea23dff79a40917273c1bf43b1ae7d9;hb=445221bb8e531d77aad987b936b30d385521134f

A1 Adapter in Frankfurt is implemented against A1 Mediator OpenAPI version 1.0.0, and will be updated to support the latest A1 Mediator OpenAPI version 2.1.0. It is observed that there are no substantial material differences between API's for versions 1.0.0 and 2.1.0. 

Detailed documentation on A1 Mediator is available at: https://docs.o-ran-sc.org/projects/o-ran-sc-ric-plt-a1/en/latest/

7. Deployment Considerations

...

• A1 Mediator/Real-RT RIC
  • A1 Mediator (Developer version 1.0.0), is currently deployed in the Windriver Lab in a standalone VM (without full RIC deployment), and can be accessed at 10.12.7.38:10001.
  • Details about RIC deployment and HELM charts can be found at:  https://gerrit.o-ran-sc.org/r/gitweb?p=ric-plt%2Fric-dep.git;a=shortlog;h=refs%2Fheads%2Fmaster
• ONAP (Non-RT RIC)
  • Use Frankfurt ONAP deployment
  • Configuration changes to the DG properties file required, if testing/deployment is done against A1 mediator other than described below
    • Properties file: /opt/onap/ccsdk/data/properties/a1-adapter-api-dg.properties
      • SSH into rancher node (NFS/rancher)
      • sudo su
      • kubectl get pods -n onap -o wide | grep sdnc
      • Execute the following command to all sdnc POD's to update properties file
        • kubectl exec -it dev-sdnc-x bash (x=0, 1, 2, depending upon number of sdnc replicas in the setup)
      • Once in the docker, edit the properties file (/opt/onap/ccsdk/data/properties/a1-adapter-api-dg.properties)
      • Make following configuration changes per setup
        • Update IP address/port# for A1 Mediator (a.b.c.d:port# below)
          • near-rt-ric-id=a.b.c.d:port#

9. A1 Mediator Testing

The following depicts DMAAP to RPC to A1 Mediator REST API flow, and test cases are also mapped against this flow.

Image Added

Mapping of flow to Test Cases described here:

Image Added

Following is the current testing environment in the WIndriver Lab:

Image Added

A1 Mediator deployed currently conforms to OpenAPI Version 1.0.0; and the OpenAPI latest version is 2.1.0. It is observed that there are no substantial material differences between API's for versions 1.0.0 and 2.1.0. 

10. To Do's

• Perform testing and further development against full-blown RIC deployment that includes A1 mediator
• Modify DG's to ensure RequestID and CorrelationID are in sync for DMAAP request and response messages
• Integrate ONAP/A1 Mediator with Near-RT deployment
• Any code changes to conform to the latest A1 Mediator OpenAPI specs (2.1.0)
• Current Gaps and Limitations
  • A1 mediator response to getStatus RPC is not rendered correctly for DMAAP response message 
  • For few API requests to A1 Mediator, there is no response message payload, and for these situations, DMAAP response message payload indicates "Working On it"

11. Supporting Documents

A1-Adapter-ONAP-Ver6.pptx

...