X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Foverview.rst;h=248766f37e5dca4f29a2ad9f4646499645a78319;hb=94fdf4782260c780be3457fe7f11dd9e1a041c02;hp=018b7b4a00fbe2a4e63893deba33c1b1f19f87b3;hpb=d16cf7f33f3cb0a104ca91a5e5db59d3ad81bb21;p=nonrtric%2Fplt%2Fa1policymanagementservice.git diff --git a/docs/overview.rst b/docs/overview.rst index 018b7b4..248766f 100644 --- a/docs/overview.rst +++ b/docs/overview.rst @@ -1,23 +1,51 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. SPDX-License-Identifier: CC-BY-4.0 -.. Copyright (C) 2021 Nordix +.. Copyright (C) 2021-2023 Nordix Foundation +.. Copyright (C) 2024: OpenInfra Foundation Europe. All rights reserved. + +O-RAN A1 Interface +~~~~~~~~~~~~~~~~~~ + +The O-RAN Alliance defines a new management interface "A1" for Radio Access Network (RAN) Management. This interface interconnects a new logical +"Non-RealTime RAN Intelligent Controller (Non-RT-RIC)" function in the Service Management & Orchestration (SMO) layer with a new logical "Near-RealTime +RAN Intelligent Controller (near-RT-RIC)" function in the RAN. This new A1 interface allows the Non-RT-RIC to provide Policy Guidance to the RAN (near-RT-RIC) +to steer its operation. These policies are defined by the O-RAN Alliance as "A1 Policies". The specifications for the A1 Interface, including A1 Policy support, +can be found on the O-RAN Alliance Specifications website. + +The A1 Policy functions are Orchestration and Automation functions for non-real-time intelligent management of RAN functions. The primary goal of the A1 Policy +functions is to support non-real-time radio resource management, higher layer procedure optimization, policy optimization in RAN, and providing guidance, +parameters, policies and AI/ML models to support the operation of Near-RealTime RIC (RAN Intelligent Controller) functions in the RAN to achieve +higher-level non-real-time objectives. + +A1 Policy functions form part of a Non-Realtime RIC as defined by O-RAN Alliance. Non-Realtime RIC functions include service and policy management, RAN analytics, +and model-training for the Near-RealTime RICs. The ONAP & O-RAN-SC A1 Policy work provides concepts, specifications, architecture and reference implementations +for A1 Policy support as defined and described in the O-RAN architecture. A1 Policy Management Service (from ONAP CCSDK) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -A1 Controller Service above A1 Controller/Adaptor that provides: +The A1 Policy Management Service is a microservice which maintains a transient repository of: -* Maintains (persistent) cache of RAN's A1 Policy information. + * All A1 policies instances in the network. Each policy is targeted to a near-RT-RIC instance and is owned by a 'service' (e.g., rApps or the NONRTRIC Dashboard). + * All near-RT-RICs in the network. + * All Policy types supported by each near-RT-RIC. - * Support RAN-wide view of A1 Policy information. - * Streamline A1 traffic. - * Enable (optional) re-synchronization after inconsistencies / near-RT-RIC restarts. - * Supports a large number of near-RT-RICs (& multi-version support). +The service provides : -* Converged ONAP & O-RAN-SC A1 Adapter/Controller functions in ONAP SDNC/CCSDK (Optionally deploy without A1 Adaptor to connect direct to near-RT-RICs). -* Support for different Southbound connectors per near-RT-RIC - e.g. different A1 versions, different near-RT-RIC version, different A1 adapter/controllers supports different or proprietary A1 controllers/EMSs. + * Unified REST API for managing A1 Policies in all near-RT-RICs. + * Compliant with O-RAN R1 specification for A1-Policy Management (R1-AP v5.0, with additional features & fixes) + * Synchronized view of A1 Policy instances for each rAPP + * Synchronized view of A1 Policy instances in each near-RT-RIC + * Synchronized view of A1 Policy types supported by each near-RT-RIC + * Lookup service to find the near-RT-RIC to control resources in the RAN as defined in O1 (e.g. which near-RT-RIC should be accessed to control a certain CU or DU, which in turn controls a certain cell). + * Monitors all near-RT-RICs and maintains data consistency, e.g. recovery from near-RT-RIC restarts + * Support for different Southbound APIs to the near-RT-RICs (different versions of the A1-P and other similar APIs). + * HTTPS can be configured to use a supplied certificate/private key and to validate peers towards a list of trusted CAs/certs. + * HTTP proxy support for tunneling HTTP/HTTPS connections. + * Fine-grained access-control - with new optional callouts to an external auth function + * Fine-grained monitoring metrics, logging & call tracing can be configured -See also A1 Policy Management Service in ONAP: `Wiki `_, :doc:`Documentation`. +See also A1 Policy Management Service in ONAP: `Wiki `_, :doc:`Documentation`. Implementation: