Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The picture below depicts overall use case flow:


Image RemovedImage Added



3. High-Level Design and Implementation Approach

...

Topic: A1-P 

{ 

    "body": { 

        "input": { 

            "CommonHeader": { 

                "TimeStamp": "2018-11-30T09:13:37.368Z", 

                "APIver": "1.0", 

                "RequestID": "9d2d790e-a5f0-11e8-98d0-529269fb1459", 

   "SubRequestID": "1", 

                "RequestTrack": {}, 

                "Flags": {} 

            }, 

            "Action": "getNearRT-RICs", 

            "Payload": {"input": {"dummy": "dummy"}} 

           }

        }, 

        "version": "1.0", 

        "rpc-name": "getNearRT-RICs", 

        "correlation-id": "9d2d790e-a5f0-11e8-98d0-529269fb1459-1", 

        "type": "request"     } 

} 


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

...

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
  • 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.

...

Mapping of flow to Test Cases described here:



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

...