Use Case Name
Use Case Overview & Description
This requirement enhances the A1 interface capabilities provided in Rel 6 as part of 5G/ORAN & 3GPP Standards Harmonization requirement ( REQ-38) and extended in Rel 7 with the introduction of A1 policy management. 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. This requirement enhances the support for Managing and Mediating O-RAN A1 Policies in ONAP. This extends work contributed in Rel 6 - Frankfurt (REQ-38) and Rel 7 - Guilin (REQ-352). A1 Adapter functionality was introduced in Frankfurt. In Guilin The A1 adapter was improved and a A1 Policy Management Service was added.
Planned enhancements for Rel 8 include: support of new A1 interface version in alignment to O-RAN alliance and , common logging/audit. improved CSIT and OOM alignment, easier configuration, an improved NBI, and improved security cert management.
Use Case Key Information
TOPIC | DESCRIPTIONInformation | WIKI PAGE | |||||||||
Requirements Proposal | This is a link to the requirements proposal made on the Requirements Sub-committee | ArchitectureS/C | infoInformation on the Architecture sub-committee presentationProposal: A1 Adapter and Policy Management Extension (ORAN/ONAP/3GPP Harmonization) | ||||||||
Project WIKI page | O-RAN A1 Policies in ONAP & This Page | ||||||||||
Prior Project "Base" Wiki | Link to the "base" wiki for the Use Case, or work from a prior release. | Requirements Jira (REQ-###) Ticket | Link to the REQ Jira ticket for this use caseONAP/3GPP & ORAN Alignment: A1 Adapter extensions (Guilin) | ||||||||
Meetings Register & Recordings | |||||||||||
Requirements Ticket |
| ||||||||||
Key Use Case Leads & Contacts | USE CASE LEAD: USE KEY CONTACTS: | Meetings Register & Recordings | Link to Use Case Team meetings. |
BUSINESS DRIVER
...
CCSDK Requirement/Epic | JIRA Ticket for Epic for A1 Policy Management in Honolulu
| ||||||||||||||||||||||
ONAP Arch Committee Review | JIRA Ticket for Review in ArchCom
2020-12-01 ONAP Architecture Subcommittee Meeting - Approved Recording:
Slides:
| ||||||||||||||||||||||
Function/Integration Test environment | Demo of OSC NONRTRIC & ONAP A1 functions at LFN Developer & Testing Forum - Feb 2021 Slides & Video: 2021-02-03 - ONAP: Demo: O-RAN A1 Policy & Non-RealTime-RIC automated test/demo environment | ||||||||||||||||||||||
Integration Tests | JIRA Ticket for Epic for Integration Tests
|
BUSINESS DRIVER
Key Contacts : John Keeney, Michela Bevilacqua
Executive Summary: This requirement enhances the A1 interface capabilities provided in Rel 6 as part of 5G/ORAN & 3GPP Standards Harmonization requirement ( REQ-38) and extended in Rel 7 with the introduction of A1 policy management.
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. This requirement enhances the support for Managing and Mediating O-RAN A1 Policies in ONAP. This extends work contributed in Rel 6 - Frankfurt (REQ-38) and Rel 7 - Guilin (REQ-352). A1 Adapter functionality was introduced in Frankfurt. In Guilin The A1 adapter was improved and a A1 Policy Management Service was added.
Planned enhancements for Rel 8 include: support of new A1 interface version in alignment to O-RAN alliance and , common logging/audit. improved CSIT and OOM alignment, easier configuration, an improved NBI, and improved security cert management.
Business Impact: Continuing the convergency convergence between ONAP and ORAN for A1 Policy interface to used by all service providers and avoid duplicate development efforts.
Business Markets: Enhanced A1 Policy capabilities, once developed, will be useable usable by any service provider deploying and using ONAP.
...
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 | N/A | ||
AAF | N/A | ||
APPC | N/A | ||
CLAMP | N/A | ||
CC-SDK | Extend existing A1 Adapter and A1 Policy Management functionality in CCSDK | CCSDK-2991 | |
DCAE | N/A | ||
DMaaP | N/A | ||
External API | N/A | ||
HOLMES | N/A | ||
MODELING | N/A | ||
Multi-VIM / |
Cloud | N/A | ||
OOF | N/A | ||
OOM | N/A | ||
POLICY | N/A | ||
PORTAL | N/A | ||
SDN-C | Extend existing A1 Adapter and A1 Policy Management functionality in SDNC deployments | ||
SDC | N/A | ||
SO | N/A | ||
VID | N/A | ||
VF-C | N/A | ||
VNFRQTS | N/A | ||
VNF-SDK | N/A | ||
CDS | N/A |
List of PTLs: Approved Projects
*Each Requirement should be tracked by its own User Story in JIRA
USE CASE DIAGRAM
Use cases define how different users interact with a system under design. Each use case represents an action that may be performed by a user (defined in UML as an Actor with a user persona).
Enhancements for Honolulu Release
- Add support for O-RAN Alliance A1-AP v2.1 specification (A1 Policy only)
- Improve alignment with OOM deployment & configuration options
- Improve alignment with CSIT way of working for function tests
- New REST interface for configuration
- New A1 Policy Management NBI (REST & DMaaP)
- Improved security cert management
- Stretch: Investigate if A1 Policy manipulation can be incorporated into other use cases (e.g. Slicing, OOF) - TBC
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:
- TBC
Interfaces:
- Northbound Interface
- Add/Change CCSDK A1 Policy Management Service NBI for A1 Policy Management (REST & DMaaP)
- The new version of the PMS REST API complies with the ONAP REST API and Zalando style guidelines and fixes some naming inconsistencies.
- REST (New version)
- DMaaP (New version)
- Ref: CCSDK-3077
- Configuration
- File based, supports dynamic refresh - including K8s ConfigMap (existing)
- CBS/Consul (existing)
- REST (New)
- Southbound Interfaces – See earlier section
- OSC A1 v2.1 (Existing)
- O-RAN A1 v1.1 (Existing)
- O-RAN A1 v2.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
Use Case Functional Definitions
...
Use Case Title | Title of the Use Case |
Actors (and System Components) | The list of Actors and System Components that participate in the Use Case |
Description | Short overview of the Use Case |
Points of Contact | Authors and maintainers of the Use Case. Use Case Lead, Key Use Case members and code contributors. |
Preconditions | A list of conditions that are assumed to be true before the Use Case is invoked Includes description of Information Consumed |
Triggers / Begins when | Describes the trigger for beginning the Use Case |
Steps / Flows (success) | Describes the sequence of steps and interactions that occur during the Use Case (may include: description, data exchanges, functionality, state changes) Interaction diagrams may be included or referenced |
Post-conditions | The expected results of the execution of the Use Case Includes description of Information Produced |
Alternate / Exception Paths | Description of any exceptions or special process that could occur during Use Case |
Related Use Cases | List of the Use Cases referenced by this Use Case |
Assumptions | Describes any assumptions that are made for this use case |
Tools / References / Artifacts | List of any tools or reference material associated with this Use Case as well as any JIRA trace-ability. List of any associated diagrams or modelling artifacts associated with the Use Case |
TESTING
Current Status
...
Testing Blockers
...
SDNC / CCSDK - A1 Adapter & A1 Policy Management Service | |
Description | 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. This requirement enhances the support for Managing and Mediating O-RAN A1 Policies in ONAP. This extends work contributed in Rel 6 - Frankfurt (REQ-38) and Rel 7 - Guilin (REQ-352). A1 Adapter functionality was introduced in Frankfurt. In Guilin The A1 adapter was improved and a A1 Policy Management Service was added. Planned enhancements for Rel 8 include: support of new A1 interface version in alignment to O-RAN alliance, common logging/audit. improved CSIT and OOM alignment, easier configuration, an improved NBI, and improved security cert management. |
Points of Contact | |
Preconditions | N/A |
Triggers / Begins when | N/A |
Steps / Flows (success) | |
Post-conditions | |
Alternate / Exception Paths | |
Related Use Cases | TBC |
Assumptions | None |
Tools / References / Artifacts | See additional information on this page |
TESTING
Test use-cases:
- Synchronize A1 Policy Information in RAN
- A1 Policy Type / Instance Operations
- A1 Policy Instance Status Operations
Current Status
- None yet
End to End flow to be Tested
**This should be a summary level Sequence diagram done in Gliffy**
...
- Currently being defined
Test Cases and Status
...
NOT YET TESTED
...
COMPLETE
...
Currently being defined