From bea4fdc8cc2bd3cfba62b77ff056de30f6b8e33f Mon Sep 17 00:00:00 2001 From: Vijay Venkatesh Kumar Date: Mon, 24 Apr 2023 12:54:30 -0400 Subject: DCAE london release notes onap-gerrit-review: -changelog-or-release-file-missing onap-gerrit-review: -missing-setup-py onap-gerrit-review: -changelog-missing Change-Id: Id218ca232af0248624fa6d01ccc4a56f9d7812b6 Signed-off-by: Vijay Venkatesh Kumar Issue-ID: DCAEGEN2-3360 Signed-off-by: Vijay Venkatesh Kumar --- docs/sections/release-notes.rst | 230 ++++++++++++++++++++- .../slice-analysis-ms/runtime_configuration.rst | 2 +- docs/tox.ini | 6 +- 3 files changed, 233 insertions(+), 5 deletions(-) diff --git a/docs/sections/release-notes.rst b/docs/sections/release-notes.rst index 17b9626b..325ef0f4 100644 --- a/docs/sections/release-notes.rst +++ b/docs/sections/release-notes.rst @@ -1,7 +1,7 @@ .. ==============================LICENSE_START========================================== .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -.. Copyright (c) 2017-2022 AT&T Intellectual Property. All rights reserved. +.. Copyright (c) 2017-2023 AT&T Intellectual Property. All rights reserved. .. Copyright 2021 Nokia Solutions and Networks. .. ==============================LICENSE_END============================================ .. _release_notes: @@ -17,6 +17,234 @@ DCAE Release Notes .. +.. ======================= +.. * * * LONDON * * * +.. ======================= + + +Version: 12.0.0 +=============== + + +Abstract +-------- + +This document provides the release notes for London release. + +Summary +------- + +The following DCAE components are available with default ONAP/DCAE chart installation: + + - Service components + - VES Collector + - HV-VES Collector + - PNF-Registration Handler + - Docker based Threshold Crossing Analytics (TCA-Gen2) + - VES OpenAPI Manager + + - Additional resources that DCAE utilizes are deployed using ONAP common charts: + + - Postgresql Database + - Mongo Database + + +These service components (mS) are available to be deployed on-demand via helm: + + - SNMPTrap Collector + - RESTConf Collector + - DataFile Collector + - PM-Mapper + - VES Mapper + - Heartbeat mS + - SON-Handler + - PM-Subscription Handler + - DataLake Handler (Admin & Feeder) + - Slice Analysis mS + - DataLake Extraction Service + - KPI-Ms + +All supported DCAE Microservices are maintained as Helm charts under `OOM repository `_ + + +All DCAE component are deployed as Kubernetes Pods/Deployments/Services through ONAP/OOM. + +For each microservices, dependencies are identified on corresponding helm chart individually. +In general, most DCAE microservice rely on Configmap for sourcing configuration updates. Each microservice can be deployed independently and based on the dcaegen2-services-common template, features can be enabled or disabled via a configuration override during deployment. + +For a list of supported features in helm, refer to :doc:`Using Helm to deploy DCAE Microservices <./dcaeservice_helm_template>`. + + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **DCAE Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | Refer :any:`Deliverable ` | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 12.0.0 London | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2023-06-15 | +| | | ++--------------------------------------+--------------------------------------------------------+ + + +New features +------------ + +*DCAE Enhancements and Features* + + +DCAEGEN2-3037 AAF certificate dependency removal + - PM-Mapper, RESTConf, VESOpenAPI enhanced to support additional property to disable certificates checks + +DCAEGEN2-3312 Improve DCAE PRH to handle Early PNF Registrations + - Support PNF registration reprocessing via Kafka persistence + +DCAEGEN2-3278 - DCAEMOD retirement + - OOM and documentation updates to formalize DCAEMOD deprecation + +DCAEGEN2-3067 AI/ML MS for IBN based closed Loop in E2E Network Slicing (POC) + - Mainstreaming the ml-prediction-ms (New mS introduction) + - Support for multiple slices (sNSSAIs) in training and prediction modules + - Use CPS instead of Config DB + - Remove RAN Simulator dependency + +*Non-Functional* + + - DCAEGEN2-3256 - Sonarcoverage improvements for DCAE components - VESCollector, Heartbeat MS, TCA-gen2 (meeting 80% or more coverage) + - DCAEGEN2-3318 - Vulnerability updates for several DCAE MS (TCA-gen2, DataFileCollector, RESTConf, VES OpenAPI Manager, KPI-MS, Mapper, PM-Mapper, PRH, DCAE-SDK, SON-handler, Slice-Analysis MS) + + + +.. _london_deliverable: + +Deliverables +------------ + +Software Deliverables + +.. csv-table:: + :header: "Repository", "SubModules", "Version & Docker Image (if applicable)" + :widths: auto + + "dcaegen2/analytics/tca-gen2", "", "onap/org.onap.dcaegen2.analytics.tca-gen2.dcae-analytics-tca-web:1.4.0" + "dcaegen2/collectors/datafile", "", "onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.10.0" + "dcaegen2/collectors/hv-ves", "", "onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.11.0" + "dcaegen2/collectors/restconf", "", "onap/org.onap.dcaegen2.collectors.restconfcollector:1.4.1" + "dcaegen2/collectors/snmptrap", "", "onap/org.onap.dcaegen2.collectors.snmptrap:2.0.7" + "dcaegen2/collectors/ves", "", "onap/org.onap.dcaegen2.collectors.ves.vescollector:1.12.3" + "dcaegen2/deployments", "healthcheck-container", "onap/org.onap.dcaegen2.deployments.healthcheck-container:2.4.0" + "dcaegen2/deployments", "dcae-services-policy-sync", "onap/org.onap.dcaegen2.deployments.dcae-services-policy-sync:1.0.1" + "dcaegen2/platform/ves-openapi-manager", "", "onap/org.onap.dcaegen2.platform.ves-openapi-manager:1.3.1" + "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakefeeder:1.1.1" + "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakeadminui:1.1.1" + "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalake.exposure.service:1.1.1" + "dcaegen2/services", "components/pm-subscription-handler", "onap/org.onap.dcaegen2.services.pmsh:2.2.3" + "dcaegen2/services", "components/slice-analysis-ms", "onap/org.onap.dcaegen2.services.components.slice-analysis-ms:1.2.1" + "dcaegen2/services", "components/kpi-ms", "onap/org.onap.dcaegen2.services.components.kpi-ms:1.2.1" + "dcaegen2/services/heartbeat", "", "onap/org.onap.dcaegen2.services.heartbeat:2.6.1" + "dcaegen2/services/mapper", "", "onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.5.0" + "dcaegen2/services/pm-mapper", "", "onap/org.onap.dcaegen2.services.pm-mapper:1.10.1" + "dcaegen2/services/prh", "", "onap/org.onap.dcaegen2.services.prh.prh-app-server:1.9.0" + "dcaegen2/services/son-handler", "", "onap/org.onap.dcaegen2.services.son-handler:2.2.1" + "dcaegen2/services/sdk", "", "DCAE SDK 1.9.3 (jar)" + +The following repositories (and containers) is POC deliverable for IBN based closed Loop in E2E Network Slicing using ML/MS. + +.. csv-table:: + :header: "Repository", "SubModules", "Version & Docker Image (if applicable)" + :widths: auto + + "dcaegen2/services", "components/ml-prediction-ms", "onap/org.onap.dcaegen2.services.ml-prediction-ms:1.0.0" + +The following repositories (and containers) have been deprecated with this release. + +.. csv-table:: + :header: "Repository", "SubModules", "Version & Docker Image (if applicable)" + :widths: auto + + "dcaegen2/platform", "mod/onboardingapi", "onap/org.onap.dcaegen2.platform.mod.onboardingapi:2.13.0" + "dcaegen2/platform", "mod/distributorapi", "onap/org.onap.dcaegen2.platform.mod.distributorapi:1.1.1" + "dcaegen2/platform", "mod/designtool", "onap/org.onap.dcaegen2.platform.mod.designtool-web:1.0.2" + "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-http:1.0.2" + "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-job:1.0.3" + "dcaegen2/platform", "mod/designtool/mod-registry", "onap/org.onap.dcaegen2.platform.mod.mod-registry:1.0.0" + "dcaegen2/platform", "mod/runtimeapi", "onap/org.onap.dcaegen2.platform.mod.runtime-web:1.3.3" + "dcaegen2/platform", "mod2/helm-generator", "Helm Generator 1.0.4 (jar)" + +With AAF deprecation by OOM project, all certificates are managed through Service-Mesh. Following container was introduced in DCAE to work with AAF for interal certificate generation. This container is no longer required with London release. + +.. csv-table:: + :header: "Repository", "SubModules", "Version & Docker Image (if applicable)" + :widths: auto + + "dcaegen2/deployments", "tls-init-container", "onap/org.onap.dcaegen2.deployments.tls-init-container:2.1.0" + + +Known Limitations, Issues and Workarounds +----------------------------------------- + + - DCAEGEN2-3184 DL-Feeder log error and configuration issue + +*Known Vulnerabilities* + +None + +*Workarounds* + +Documented under corresponding jira if applicable. + +Security Notes +-------------- + +*Fixed Security Issues* + + Documented on earlier section + +*Known Security Issues* + + None + +*Known Vulnerabilities in Used Modules* + + None + +DCAE code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project `_. + +Test Results +------------ + + - `DCAE R12 Pairwise Test `_ + - `DCAE R12 Functional Test `_ + + +References +---------- + +For more information on the ONAP London release, please see: + +#. `ONAP Home Page`_ +#. `ONAP Documentation`_ +#. `ONAP Release Downloads`_ +#. `ONAP Wiki Page`_ + + +.. _`ONAP Home Page`: https://www.onap.org +.. _`ONAP Wiki Page`: https://wiki.onap.org +.. _`ONAP Documentation`: https://docs.onap.org +.. _`ONAP Release Downloads`: https://git.onap.org + +Quick Links: + + - `DCAE project page `_ + - `Passing Badge information for DCAE `_ + + .. ===================== .. * * * KOHN * * * diff --git a/docs/sections/services/slice-analysis-ms/runtime_configuration.rst b/docs/sections/services/slice-analysis-ms/runtime_configuration.rst index d8f711fc..a0772c86 100644 --- a/docs/sections/services/slice-analysis-ms/runtime_configuration.rst +++ b/docs/sections/services/slice-analysis-ms/runtime_configuration.rst @@ -3,7 +3,7 @@ Runtime Configuration ===================== -The Slice Analysis MS provides an easy way to receive runtime configurations through Policy, another ONAP module. Runtime configuration is initially developed to meet the requirements of the ONAP Kohn release IBN use case. If you want to use this function, please also refer to https://wiki.onap.org/display/DW/R11+General+Intent+Model+and+General+Intent+Interface+Requirements +The Slice Analysis MS provides an easy way to receive runtime configurations through Policy, another ONAP module. Runtime configuration is initially developed to meet the requirements of the ONAP Kohn release IBN use case. If you want to use this function, please also refer to https://wiki.onap.org/pages/viewpage.action?pageId=138872665 This page will explain how runtime configuration works, and how to utilize it. Hopefully this page can help you develop your own runtime configuration to meet your own requirements. diff --git a/docs/tox.ini b/docs/tox.ini index 2efcc2a3..0b14548c 100644 --- a/docs/tox.ini +++ b/docs/tox.ini @@ -10,7 +10,7 @@ deps = -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master commands = - sphinx-build -b html -n -d {envtmpdir}/doctrees ./ {toxinidir}/_build/html + sphinx-build -W -b html -n -d {envtmpdir}/doctrees ./ {toxinidir}/_build/html whitelist_externals = echo @@ -24,7 +24,7 @@ deps = -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master #Link Check not enforced -commands = sphinx-build -q -b linkcheck -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/linkcheck +commands = sphinx-build -W -q -b linkcheck -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/linkcheck [testenv:docs-spellcheck] basepython = python3.8 @@ -33,4 +33,4 @@ deps = -chttps://raw.githubusercontent.com/openstack/requirements/stable/yoga/upper-constraints.txt -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master #Spell Check not enforced -commands = sphinx-build -q -b spelling -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/spellcheck +commands = sphinx-build -W -q -b spelling -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/spellcheck -- cgit 1.2.3-korg