Highlights - Features and Improvements
The sixth release of SD-RAN project brings three major highlights to the RIC and 5G RAN, (1) updating xApps to enable O-RAN E2SM-RC instead of using ONF E2SMs, (2) updating SD-RAN OAI 5G RAN stack to work with SD-RAN RIC, and (3) integrating Aether-OnRamp blueprint for enhanced SD-RAN deployment.
In this release, we integrated the official O-RAN E2SM RC service model (v1.02.03). We accordingly replaced the underlying service models at PCI, MLB, and MHO xApps from ONF community E2SMs such as E2SM RC-Pre and MHO to the official O-RAN E2SM RC service model. This is to expand SD-RAN coverage, so that RAN vendors or users/developers can use/test more official O-RAN SM features. SD-RAN 1.4 release has the only one use-case that exploits the official O-RAN SM - KPIMON xApp running with O-RAN E2SM KPM. However, from this SD-RAN 1.5 release, there are four use-cases leveraging the the official O-RAN SM - KPIMON (with KPM), PCI, MHO, and MLB (with RC). The following table summarizes the use-cases and their service models.
Use Case | xApps | Service Model | SD-RAN/OAI CU/DU | RAN-Sim |
---|---|---|---|---|
KPI Monitoring | onos-kpimon | O-RAN E2SM-KPM v2.00.03 | E2-AP v2.0 | E2-AP v2.0 |
PCI Conflict Resolution | onos-pci | O-RAN E2SM-RC v1.02.03 | E2-AP v2.0 | E2-AP v2.0 |
Mobility Load Balancing | onos-mlb | O-RAN E2SM-RC v1.02.03 | E2-AP v2.0 | E2-AP v2.0 |
Mobile Handover | onos-mho | O-RAN E2SM-RC v1.02.03 | E2-AP v2.0 | E2-AP v2.0 |
RAN Slicing Management | onos-rsm | ONF RSM v1.0 | E2-AP v2.0 | E2-AP v2.0 |
Policy Driven Traffic Steering | rimedo-ts | ONF MHO v2.0 | E2-AP v2.0 | E2-AP v2.0 |
In addition, this release supports one more RAN stack ONF/OAI 5G RAN stack. Although previous SD-RAN releases also provide the OAI RAN stack option, it is just 4G RAN stack with the official O-RAN E2SM KPM and the Aether community E2SM RSM service models. We implemented the E2 agent to the OAI RAN stack and pushed it to our ONF/OAI repository. As of now, this RAN stack supports the official O-RAN E2SM KPM service model with plans to support the RSM service model in the future.
We added a new Aether-OnRamp blueprint, SD-RAN blueprint, for deployment automation of this SD-RAN release. This more closely aligns SD-RAN with overall Aether Project, i.e., a user/developer can deploy a set of SD-RAN components along with the other Aether services such as SD-Core, ROC, etc. over the same cluster. Of course, SD-RAN already has an automation tool called sdRan-in-a-Box (RiaB), which could create a local Kubernetes cluster and deploy SD-RAN components on top of that. However, this is not supported as an Aether-wide project, but is specifically for SD-RAN project deployments only - a local tool. Aether-OnRamp is an Aether-wide project tool to deploy Aether components with the same environment. Thus, we integrated SD-RAN into Aether-OnRamp. Even though RiaB is currently still active and valuable for the 4G OAI deployment automation, we will deprecate it in future releases and enrich the Aether-OnRamp SD-RAN blueprint for the complete RiaB replacement.
In this release, SD-RAN does not support python-sdk for python-xApps due to the lack of developers/engineers/maintainers. Sometime in the future, if we can get more resources, we will resume python-based project. At this time, we will pause and deprecate it.
In this release, we started using Github Action for our CI. Previously, we used Jenkins for CI/CD to build/test code, package images/helm charts, and to publish them, however, this was too slow, as Jenkins job provisions AWS VM and run script. In order to reduce this delay, we replaced Jenkins with Github Action, which is significantly faster. From a cost perspective, Github Action is much better since it does not limit the Action quota for the open-source project and enables us to fully utilize the Github Action features.
Summary:
Update xApp and SM to support O-RAN E2SM-RC
Introduce Aether-OnRamp SD-RAN
Integrated 5G OAI CU/DU
Deprecating Python-based xApps and python-sdk
CI - Jenkins → Github action
Test
All existing tests were dropped - see the known issues.
Unit test / CI is migrated to Github Action.
Deployment
When using RiaB, please refer to RiaB documentation in docs.sdran.org.
When using Aether-OnRamp, please refer to Aether-OnRamp SD-RAN documentation in docs.sdran.org.
For hardware setup, please check the Hardware installation doc in docs.sdran.org.
Documentation
All release documentation is available at docs.sd-ran.org.
Known Issues
xApp A1 policy consistent problem: a new A1-enabled xApp should not be added if there are already A1 policies added. If it happens, the new xApp is unable to get the old A1 policies already added. The new xApp only has the A1 policies which are pushed after the xApp is deployed.
ONOS-E2T is not perfectly working with Viavi simulator.
SD-RAN/OAI CU/DU does not have the latest OAI code.
All integration, smoke, E2E tests were disabled. In the next release, we will try to make one by one with Github Action.
Component Versions
Component | SD-RAN 1.5.0 |
---|---|
sd-ran (umbrella chart) | 1.5.0 |
onos-api | v0.10.31 |
onos-ric-sdk-go | v0.8.12 |
onos-ric-sdk-py | deprecated |
onos-proxy | v0.0.6 |
onos-lib-go | v0.10.24 |
onos-e2-sm | v0.8.43 |
onos-e2t | v0.11.25 chart 1.5.4 |
onos-uenib | v0.3.5 chart 1.4.2 |
onos-topo | v1.0.3 chart 1.5.2 |
onos-config | v1.1.4 chart 1.8.13 |
onos-operator | v0.5.5 chart 0.5.9 |
ran-simulator | v0.10.16 chart 1.4.18 |
onos-cli | v0.9.38 chart 1.3.18 |
onos-kpimon | v0.4.11 chart 0.9.10 |
onos-pci | v0.4.17 chart 0.9.18 |
onos-mlb | v0.3.8 chart 0.3.7 |
onos-exporter | v0.4.1 chart 0.5.2 |
onos-rsm | v0.2.7 chart 0.2.7 |
onos-mho | v0.3.12 chart 0.3.9 |
onos-a1t | v0.2.3 chart 0.2.4 |
onos-a1-dm | 0.0.8 |
onos-o1t | v0.8.3 chart 0.3.5 |
oai/onf du | v0.1.11 chart 0.2.5 (5G does not support cloud-native way, but just build binary and run it from the other machine) |
oai ue | v0.1.7 chart 0.2.5 (for nFAPI); sdran-1.1.2 chart 0.1.10 (for USRP hardware) |
sdran-in-a box (RiaB) | v1.5.0 |
rimedo-ts | v0.0.5 chart 0.1.2 |
fb-ah-gui | deprecated |
ah-eson-test-server | deprecated |
fb-ah-xapp | deprecated |
fb-kpimon-xapp | deprecated |
atomix/atomix-runtime | 1.1.2 |