ONAP/3GPP & ORAN Alignment: A1 Adapter extensions
Use Case Name
A1 Adapter Extensions | @Michela Bevilacqua , @John Keeney (Ericsson EST) |
- 1 Use Case Name
- 2 Use Case Key Information
- 3 Business Driver
- 4 Development Status
- 5 Owners
- 6 Background
- 7 Enhancements for Guilin Release
- 8 Use Case Functional Definitions
- 9 Other Impacts
- 10 Testing
- 11 Use Case Functional Definitions
- 12 News & Updates:
Use Case Key Information
Topic | Description | Link |
---|---|---|
Wiki Page | Documentation | |
Architecture Subcommittee | Presentations and JIRA Tickets for Architecture Subcommittee made May 26, 2020 | |
5G Use Case Requirement | JIRA Ticket for Guilin Use Case Requirements | |
CCSDK Requirement/Epic | JIRA Ticket for Epic for A1 Adapter Evolution in Guilin | |
CCSDK Requirement/Epic | JIRA Ticket for Epic for A1 Policy Management in Guilin | |
Integration Story | JIRA Ticket for User Story for Integration testing with OSC A1 simulator | |
CSIT Story | Add CSIT tests to show A1 Policy end-to-end flow - Guilin | |
CCSDK A1 Policy Management Service NBI / API | JIRA Ticket for CCSDK A1 Policy Management Service NBI/API - Guilin | CCSDK-2489: Unified REST & DMaaP NBI for A1 Policy Management - A1 GuilinClosed |
Deployment (A1 Adapter) | Story for deploying A1 adapter in Guilin (SDNC, CCSDK, OOM) | |
Deployment (A1 Policy Management) | Story for A1 Policy Management in Guilin (OOM) | CCSDK-2492: Deployment of A1 Policy Management Service - A1 GuilinClosed |
Testing | Story for TEST Release Requirement (+ linked resources) | |
API Documentation | Stories for Documentation (A1 Policy Management Service & A1 Adapter) |
Business Driver
EXECUTIVE SUMMARY - This requirement enhances the A1 adapter/interface capabilities provided in Rel 6 as part of 5G/ORAN & 3GPP Standards Harmonization requirement ( REQ-38). O-RAN has defined A1 interface specification in the context of the management of 5G RAN elements to provide intent based policies for optimization of the RAN network performance. Planned enhancements for Rel 7 include additional support for managing A1 Policies, multiple A1 targets in the RAN, multi-version support for different A1 targets, and secure TLS communication.
BUSINESS IMPACT- Continuing the convergency between ONAP and ORAN initiated in Rel 6, A1 interface can be used by all service providers and avoid duplicate development effort.
.BUSINESS MARKETS -Enhanced A1 capabilities, once developed, will be useable by any service provider deploying and using ONAP.
FUNDING/FINANCIAL IMPACTS - A1 interface provides a flexible way for the operator to manage wide area RAN network optimization, reducing capex investment needs.
ORGANIZATION MGMT, SALES STRATEGIES - There is no additional organizational management or sales strategies for this use case outside of a service providers "normal" ONAP deployment and its attendant organizational resources from a service provider.
Development Status
PROJECT | PTL | User Story / Epic | Requirement |
A&AI | @James Forsyth | NO IMPACT | |
AAF | @Jonathan Gathman | NO IMPACT | |
APPC | @Takamune Cho | NO IMPACT | |
CLAMP | @Gervais-Martial Ngueko | TBC | |
CC-SDK | @Dan Timoney |
| |
DCAE | @Vijay Kumar | NO IMPACT | |
DMaaP | @Mandar Sawant | NO IMPACT | |
External API | @Matthieu Geerebaert | NO IMPACT | |
MODELING | @Hui Deng | TBC | |
Multi-VIM / Cloud | @Bin Yang | NO IMPACT | |
OOF | @Shankaranarayanan Puzhavakath Narayanan | TBC | |
POLICY | @Pamela Dragosh | NO IMPACT | |
PORTAL | @Manoop Talasila | NO IMPACT | |
SDN-C | @Dan Timoney |
| |
SDC | @Ofir Sonsino | NO IMPACT | |
SO | @Seshu Kumar Mudiganti | NO IMPACT | |
VID | @ittay | NO IMPACT | |
VNFRQTS | @Steven wright | NO IMPACT | |
VNF-SDK | @victor gao | NO IMPACT | |
CDS | @Yuriy Malakov | NO IMPACT |
Owners
@John Keeney (Ericsson EST)
@Michela Bevilacqua
Background
O-RAN A1 Interface:
The O-RAN architecture introduces a new management interface - “A1 interface” - between the network management system and the radio access network (RAN)
A1-AP (Application Protocol) specified by O-RAN Alliance WG2
A1 interface enables vendor-agnostic policy-based guidance (“A1 Policies”) to be sent to underlying RAN elements from the management system.
“A1-EI” will also support transmission of enrichment information from the management platform to the RAN elements (Still being defined – currently out of scope)
“A1-ML/AI” may also assist with ML Model management in the RAN (Still being defined – currently out of scope)
The A1 interface connects Non-RealTime-RIC logical function in OAM/SMO layer with the Near-RealTime-RIC logical function in the RAN.
A1 in O-RAN Architecture for Disaggregated RAN
From ORAN-WG1 Architecture Description - v01.00.00 - https://www.o-ran.org/specifications
A1 Adapter in Frankfurt
Implemented as an SDNC/CCSDK extension to terminate & expose A1 interface
https://lf-onap.atlassian.net/wiki/display/DW/A1+Adapter+in+ONAP
Developed for Release Requirement (REQ-38): 5G / ORAN & 3GPP Standards Harmonization
Can be used by other ONAP functions to perform A1 Policy Operations over A1 Interface
Provides DMaaP northbound interface, and REST (A1) southbound interface
Enhancements for Guilin Release
Add additional support for standardized A1 protocol (O-RAN A1-AP v1.1)
Current (Frankfurt) supports only O-RAN-SC’s (draft) non-spec version of A1 Application Protocol
Will add support for upcoming A1 standard spec evolution
Will add support for multiple versions for different A1 connections
Managing A1 Policies
Operations:
Query A1 Policy Types in near-RT-RICs
Create/Query/Update/Delete A1 Policy Instances in near-RT-RICs
Query Status for A1 Policy Instances
Maintain transient cache of RAN’s A1 Policy information
Support RAN-wide view of A1 Policy information
Streamline A1 traffic
Enable (optional) re-synchronization after inconsistencies / near-RT-RIC restarts
Add support for multiple near-RT-RICs (with multi-version support)
Unified REST & DMaaP NBI
Add support for TLS/HTTPS REST for southbound A1 interfaces (and NBIs)
Leverage existing ONAP cert management approaches
Converge ONAP & O-RAN-SC A1 Adapter/Controller functions in ONAP SDNC/CCSDK
Proposed functionality is currently available as 2 functions in O-RAN-SC
Basic A1 Adapter is an ODL extension & Policy Management is a separate microservice
A1 Policies - Northbound Interface (REST & DMaaP) Proposed
See CCSDK-2489: Unified REST & DMaaP NBI for A1 Policy Management - A1 GuilinClosed and Open API (yaml)
Policy Types / Policy Instances / Policy Status Operations (REST)
/policies?ric=yy&service=zz&type=xx (GET)
/policy?id=ww (GET, PUT, DELETE)
/policy_types?ric=zz (GET)
/policy_schema?id=xx (GET)
/policy_schemas?ric=yy (GET)
/policy_status?id=ww (GET)
DMaaP
Inbound request (Topic can be configured)
{
"type": "string",
"correlationId": "string",
"target": "string",
"timestamp": "timestamp",
"apiVersion": "string",
"originatorId": "string",
"requestId": "string",
"operation": "string",
"url": "string",
"body": "string"
}
Example
To get all policy types for a specific Near‑RT RIC:
{
"type":"request",
"correlationId":“xyz123",
"target":"policy-agent",
"timestamp":"<timestamp>",
"apiVersion":"1.0",
"originatorId":“12345",
"requestId":“6789",
"operation":"GET",
"url":"/policy_schemas?ric=ric_1"
}
Outbound Response (Topic can be configured
{
"requestId": "string",
"correlationId": "string",
"originatorId": "string",
"type": "string",
"message": "string",
"type": "string",
"timestamp": "string",
"status": "string"
}
Example
The response containing all policy types for a specific Near‑RT :
{
"requestId":"6789",
"correlationId":“xyz123",
"originatorId":" 12345",
"type":"response",
"message":" <response – in this case an array
of Policy type schemas> ",
"timestamp":"<timestamp>",
"status":"200 OK"
}
Propose to deprecate / phase out existing A1 Adapter DMaaP Interface
A1 Policies – Southbound (A1-P Application Protocol)
O-RAN Alliance (spec) v1.1.3 (Proposed)
/A1-P/v1/policies (GET)
/A1-P/v1/policies/{policyId} (GET, PUT, DELETE)
/A1-P/v1/policies/{policyId}/status (GET)
O-RAN-SC A1 (non-spec) v2.1.0 (Existing)
/a1-p/healthcheck (GET)
/a1-p/policytypes (GET)
/a1-p/policytypes/{policy_type_id} (GET, DELETE, PUT)
/a1-p/policytypes/{policy_type_id}/policies (GET)
/a1-p/policytypes/{policy_type_id}/policies/{policy_instance_id} (GET, DELETE, PUT)
/a1-p/policytypes/{policy_type_id}/policies/{policy_instance_id}/status (GET)
Use Case Functional Definitions
Synchronize A1 Policy Information in RAN
A1 Policy Type / Instance Operations
A1 Policy Instance Status Operations
Other Impacts
Affected ONAP Functions:
SDNC / CCSDK only
Integration of bordering ONAP components:
Guilin: None required – Studies only
Stretch Goal: “Hello world” demonstrations with other ONAP components
Honolulu: A&AI, Configuration & Persistency Service, DCAE, CLAMP, Policy. (TBC)
Will form part of cross-project 5G integration use cases envisioned for Honolulu (TBC)
Interfaces:
Northbound Interface – See earlier section
Add/Change SDNC NBI for A1 Policy Management (REST & DMaaP)
REST (New)
DMaaP (New – Deprecate Existing – goes beyond existing A1 interface message mediation)
Southbound Interfaces – See earlier section
OSC A1 v2.1 (Existing)
O-RAN A1 v1.1 (New)
Usage outside ONAP:
Used in O-RAN-SC NONRTRIC Project (Downstream)
Southbound Interface: O-RAN A1 Interface + Information Model is specified and maintained by O-RAN Alliance
Modelling Impacts:
TBC
Other:
Update Documentation with A1 interface aspects
Update Integration & Existing Test requirements
Testing
Test use-cases:
Synchronize A1 Policy Information in RAN
A1 Policy Type / Instance Operations
A1 Policy Instance Status Operations
See REQ-447 and linked resources for more information on TEST Release Requirements
Test variations:
A1 Adapter with/without A1 Policy Management Service
A1 versions:
O-RAN Alliance (spec) v1.1.3
O-RAN-SC A1 (non-spec) v2.1.0
OSC A1 Simulator:
Integration Story:
Current Status
End to End flow to be Tested
Test Cases and Status
1 |
| COMPLETE |
2 |
| COMPLETE |
3 |
| COMPLETE |
Use Case Functional Definitions
Use Case Title | A1 Adapter extensions |
Actors (and System Components) | SDNC / CCSDK - A1 Adapter |
Description | This requirement enhances the A1 adapter/interface capabilities provided in Rel 6 as part of 5G/ORAN & 3GPP Standards Harmonization requirement ( REQ-38). O-RAN has defined A1 interface specification in the context of the management of 5G RAN elements to provide intent based policies for optimization of the RAN network performance. Planned enhancements for Rel 7 include additional support for managing A1 Policies, multiple A1 targets in the RAN, multi-version support for different A1 targets, and secure TLS communication. |
Points of Contact | @Michela Bevilacqua @John Keeney (Ericsson EST) |
Preconditions | N/A |
Triggers / Begins when | N/A |
Steps / Flows (success) | Extend A1 adapter Support in CCSDK/SDNC Add A1 Policy Management functionality |
Post-conditions | Service can perform A1 Policy Management operations over O-RAN A1 interface using SDNC/CCSDK function NBIs (DMaaP & REST) |
Alternate / Exception Paths | N/A |
Related Use Cases | TBC |
Assumptions | None |
Tools / References / Artifacts | See information in the text above. |
News & Updates:
May 26, 2020 - GO decision from Architecture Sub-Committee: Presentation:
Jun 24, 2020 - Presentation to LFN vDTF (June 2020): "A1 Adapter in OSC and ONAP -Converging A1 Control in ONAP (Guilin)"