X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Frelease%2Findex.rst;h=734d5599050fde3e0c939ad534952f04391cbe92;hb=52c45d827ecc6fcaf55a51e5ffa684e077feb0ac;hp=52db1578af5b8863f6c973d4eeccc0a09ca1a545;hpb=84424f0ff41104e0dc9fedede93fbea9b72bb6ed;p=doc.git diff --git a/docs/release/index.rst b/docs/release/index.rst index 52db1578a..734d55990 100644 --- a/docs/release/index.rst +++ b/docs/release/index.rst @@ -1,206 +1,290 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. http://creativecommons.org/licenses/by/4.0 -Casablanca Release Notes -^^^^^^^^^^^^^^^^^^^^^^^^ -This page is the ONAP Casablanca Release Notes. The first release was labelled -Amsterdam, second release Beijing and subsequent major release will be named -using city names. - -* Release Name: Casablanca -* Release Version: 3.0.0 -* Release Date: Nov 30, 2018 - - -Getting Started With ONAP -========================= - -Summary -------- -ONAP provides a comprehensive platform for real-time, policy-driven -service orchestration and automation including virtual network functions and -applications instantiation and configuration, but also physical network -functions configuration. -ONAP will enable software, network, IT and cloud providers and developers -to rapidly automate new services and support complete life cycle management. -By unifying member resources, ONAP will accelerate the development of a -vibrant ecosystem around a globally shared architecture and implementation -for network automation-with an open standards focus-faster than any one -product could on its own. - -Functionality -------------- -**Portal** - a single, consistent user experience for both design time -and run time environments, based on the user’s role. - -**Design Time Framework** - a comprehensive development environment with -tools, techniques, and repositories for defining/describing resources, -and services: - - - Service Design and Creation (SDC) provides tools, techniques, and - repositories to define/simulate/certify system assets as well as their - associated processes and policies. - - - A VNF Software Development Kit (VNFSDK) and VNF Validation Program (VVP) - with tools for VNF supplier packaging and validation. - - - Policy Creation (POLICY) deals with conditions, requirements, - constraints, attributes, or needs that must be provided, maintained, - and/or enforced. - - - Closed Loop Automation Management Platform (CLAMP) provides a method - for designing and managing control loops. - - - Optimization Framework (OOF) provides a policy-driven and model-driven - framework for creating optimization applications. - -**Runtime Framework** - The runtime execution framework executes the -rules and policies distributed by the design and creation environment -and Controllers that manage resources corresponding to their assigned -controlled domain: - - - Service Orchestrator (SO) executes the specified BPMN processes and - automates sequences of activities, tasks, rules and policies needed for - on-demand creation, modification or removal of network, application or - infrastructure services and resources. SO is especially able to drive - any OpenStack-based cloud platform. - - - Software Defined Network Controller (SDNC) executes network configuration - for cloud computing resources and network. - - - Application Controller (APPC) executes Virtual Network Functions (VNF) - configurations and lifecycle management operations. - - - Virtual Function Controller (VF-C) is responsible for lifecycle management - of virtual network functions and network services based on VNF using - VNF Manager. - - - Active and Available Inventory (A&AI) provides real-time views of a - system’s resources, services, products and their relationships with each - other. - -**Closed-Loop Automation** -- Design -> Create -> Collect -> Analyze > -Detect -> Publish -> Respond: - - - Data Collection, Analytics and Events (DCAE) collects events, performance, - usage and publishes information to policy that executes the rules to perform - closed loop actions. - - - Holmes provides alarm correlation and analysis for Telecom cloud - infrastructure and services, including servers, cloud infrastructure, - VNFs and Network Services. - - - Common Services - operational services for all ONAP components including - activity logging, reporting, common data layer, access control, resiliency, - multisite state coordination, credential/secret management and - software lifecycle management. - -**Microservices Support** - - - ONAP Operation Manager (OOM) use Kubernetes and Helm to manage ONAP - components. - - Microservices Bus (MSB) provides service registration/discovery, - external API gateway, internal API gateway, client software development kit - (SDK), and Swagger SDK. -Project Specific Release Notes -============================== -ONAP releases are specified by a list of project artifact -versions in a :ref:`manifest`. +.. _onap-release-notes: -.. toctree:: - :hidden: +Guilin Release Notes +^^^^^^^^^^^^^^^^^^^^ - release-manifest.rst +This page provides the release notes for the ONAP Guilin release. This +includes details of software versions, known limitations, and outstanding +trouble reports. -Each project provides detailed :ref:`release notes` -and prepends to these if/when any updated versions the project team believes -are compatible with a major release are made available. +Release notes are cumulative for the release, meaning this release note will +have an entry for each Major, Minor, and Maintenance release, if applicable. + +Each component within the ONAP solution maintains their own component level +release notes and links to those release notes are provided below. +Details on the specific items delivered in each release by each component is +maintained in the component specific release notes. + +Guilin Releases +=============== + +The following releases are available for Guilin: + - `Guilin Maintenance Release 7.0.1`_ + - `Guilin Major Release 7.0.0`_ -.. index:: Download +Guilin Maintenance Release 7.0.1 +================================ -Installation ++--------------------------------------+--------------------------------------+ +| **Project** | Open Network Automation Platform | +| | (ONAP) | ++--------------------------------------+--------------------------------------+ +| **Release name** | Guilin Maintenance Release | +| | | ++--------------------------------------+--------------------------------------+ +| **Release version** | 7.0.1 | +| | | ++--------------------------------------+--------------------------------------+ +| **Release date** | February 28th 2021 | +| | | ++--------------------------------------+--------------------------------------+ + +New Features ============ -ONAP is installed using -:ref:`ONAP Operations Manager (OOM) over Kubernetes` -Documentation -============= -ONAP Casablanca Release provides multiple documents including the following: +Guilin Maintenance Release 7.0.1 delivered a number of fixes and updates +across the following projects: + + - AAI - bug fixes + - OOM - bug fixes + - CCSDK - bug fixes + - DCAEGEN2 - bug fixes + - DMaaP - bug fixes + - DOC - restructure user guides section and added tutorials + - Integration - new docker for robot framework + - Music - certificate update + - MSB - bug fixes + - OOM - docker improvement + - SDNC - bug fixes + - SO - bug fixes + - VID - certificate update + +Details on the specific Jira tickets addressed by each project can be found in +the component specific Release Notes: :ref:`release notes` + + +Guilin Major Release 7.0.0 +========================== + ++--------------------------------------+--------------------------------------+ +| **Project** | Open Network Automation Platform | +| | (ONAP) | ++--------------------------------------+--------------------------------------+ +| **Release name** | Guilin | +| | | ++--------------------------------------+--------------------------------------+ +| **Release version** | 7.0.0 | +| | | ++--------------------------------------+--------------------------------------+ +| **Release date** | December 3rd 2020 | +| | | ++--------------------------------------+--------------------------------------+ + +Guilin Features +=============== +ONAP Guilin focusses on: + +* 5G network automation and services such as network slicing through RAN, core + and transport +* deepening O-RAN Software Community integration along with other leading SDOs +* seamless orchestration of CNFs, VNFs and PNFs +* and bringing several new ONAP Blueprint and docs updates. + +5G Network Slicing +------------------ +In the industry evolution toward 5G networks, Guilin expands upon the +end-to-end network slicing introduced with Frankfurt with the addition of RAN, +core, and transport through Network Slice Subnet Management Function (NSSMF) +which completes functionality with the Communication Service Management +Function (CSMF) and Network Slice Management Function (NSMF) components. In +addition to the NSSMF included in Guilin, ONAP supports an external RAN NSSMF. +Next, the RAN domain also has initial support for a simple closed control loop +and machine learning (ML) for intelligent slicing. + +ONAP/O-RAN Alignment +-------------------- +The release also marks greater ONAP + O-RAN Software Community harmonization by +adding support for the A1 interface (O-RAN A1-AP v1.1), adding to the existing +O1 support. ONAP can now manage multiple A1 targets with different versions and +includes a A1 Policy Management Service that interacts with the Near Real-Time +RICs policy instances and provides a transient cache for these policies. + +CNF, VNF and PNF integration +---------------------------- +Guilin contains a large number of new features classified into design time, +run time, and ONAP operations to optimize the self-serve control loop and +dashboard, make it easier to reuse existing models, make xNF pre-onboarding and +onboarding easier, speed up UI development, and more. For Documentation +(Usability), ONAP documentation made improvements such as setting up ONAP, +Platform Operations, Service Design and Deployment, and User Guides. Specific +to cloud native, The Service Design & Creation (SDC) project, the unified +design time tool, now supports Helm types to natively support Cloud Native +Network Functions (CNF). + +Enhancements in ONAP Blueprints +------------------------------- +Other enhancements to the ONAP Blueprints includes a new Standard Defined VNF +Event Stream (VES) event for Fault Management (FM) / Performance Management +(PM) Data Collection, the first use of Machine Learning in Self-Organizing +Networks (SON), and greater support for 5G RAN Wireless Network Resource Model +(NRM) with Service Modeling and Definition and Intent Based Network supporting +intent-drive 5G slice creation. The Cross Domain and Cross Layer VPN (CC-VPN) +includes transport slicing and the MDONS (Multi-Domain Optical Network Service +) has been extended. + +Functional Requirements +----------------------- +The following requirements have been introduced in the Guilin Release: + +xNF Integration +............... + +- ONAP CNF orchestration - Enhancements +- Extension of PNF Pre-onboarding/onboarding +- Enhancements for PNF Plug & Play' +- xNF License Management + +Lifecycle Management +.................... + +- Policy Based Filtering +- CLAMP Deployment of Native policies +- Bulk PM / PM Data Control Extension +- Support xNF Software Upgrade in association to schema updates +- Configuration & Persistency Service + +Security +........ + +- CMPv2 Enhancements + +Standard alignment +.................. + +- ETSI-Alignment for Guilin +- ONAP/3GPP & O-RAN Alignment-Standards Defined Notifications over VES +- Extend ORAN A1 Adapter and add A1 Policy Management + +NFV testing Automatic Platform +............................... + +- Test Result Auto Analysis & Certification +- Test Task Auto Execution +- Test Environment Auto Deploy +- Test Topology Auto Design + +Non-Functional Requirements +--------------------------- +The following 'non-functional' requirements have been introduced in the Guilin +Release: + +Best Practice +............. + +- ONAP shall use STDOUT for logs collection +- IPv4/IPv6 dual stack support in ONAP (Guilin) +- Containers must crash properly when a failure occurs +- Containers must have no more than one main process +- Application config should be fully prepared before starting the + application container +- No root (superuser) access to database from application container + +Code Quality +............ + +- Each ONAP project shall improve its CII Badging score by improving input + validation and documenting it in their CII Badging site +- Each ONAP project shall define code coverage improvements and achieve at + least 55% code coverage + +Security +........ + +- ONAP must complete update of the Python language (from 2.7 -> 3.8) +- ONAP must complete update of the java language (from v8 -> v11) +- All containers must run as non-root user +- Continue hardcoded passwords removal +- Flow management must be activated for ONAP. +- Each project will update the vulnerable direct dependencies in their code + base + +Tests +..... + +- More tests integrated in CI/CD but enhancements expected in Honolulu +- ONAP shall increase the number of Docker Benchmark tests + +Others +...... + +- ONAP to support Multi - tenancy + +.. important:: + Some non-functional requirements are not fully finalized. Please, check details + on the :ref:`Integration` - * A high level :ref:`architecture view` of how components - relate to each other. - * A collection of documentation provided - by :ref:`each project `. +Project Specific Release Notes +============================== +ONAP releases are specified by a list of project artifact versions in the +project repositories and docker container image versions listed in the OOM +Helm charts. - * Application Programming Interface - Reference :ref:`available here `. +Each project provides detailed :ref:`release notes` +and prepends to these if/when any updated versions the project team believes +are compatible with a major release are made available. - * The `developer wiki `_ remains a good source of - information on meeting plans and notes from committees, project teams and - community events. +Documentation +============= +ONAP Guilin Release provides a set selection of documents, +see `ONAP Documentation `_. -.. index:: Licensing +The `developer wiki `_ remains a good source of +information on meeting plans and notes from committees, project teams and +community events. Security Notes ============== -ONAP has adopted the -`CII Best Practice Badge Program `_. -The goal of the Casablanca release is for all ONAP projects to be close to -achieving a CII Passing badge. +Details about discovered and mitigated vulnerabilities are in +:ref:`ONAP Security ` + +ONAP has adopted the `CII Best Practice Badge Program `_. -- `Badging Requirements `_ +- `Badging Requirements `_ - `Badging Status for all ONAP projects `_ -Project specific details are in the :ref:`release notes` -for each project. +In the Guilin release, + +- 100% projects passed 90% of the CII badge +- 85% projects passed the CII badge +- 11% projects passed the CII Silver badge + +Project specific details are in the :ref:`release notes` for +each project. .. index:: maturity -  + ONAP Maturity Testing Notes =========================== -For the Casablanca release, ONAP continues to improve in multiple areas of  +For the Guilin release, ONAP continues to improve in multiple areas of Scalability, Security, Stability and Performance (S3P) metrics. -  -The Integration team ran the 72 hours stability testing (100% passing rate)  -and full resilience testing (96.9% passing rate) at ONAP OpenLabs. More details in :ref:`ONAP Maturity Testing Notes `  -Licenses -======== -ONAP Source Code is licensed under the `Apache Version 2 License -`_. -ONAP Documentation is licensed under the `Creative Commons Attribution 4.0 -International License `_. +In Guilin the Integration team focussed in + +- Automating ONAP Testing to improve the overall quality +- Adding security and E2E tests +- Integrated new ONAP Python SDK in E2E testing + +More details in :ref:`ONAP Integration Project` Known Issues and Limitations ============================ Known Issues and limitations are documented in each :ref:`project Release Notes `. -.. index:: Reporting Bugs - -How to Report a Bug -=================== -There are 2 ways to report a bug in ONAP. - - * In case you are familiar within ONAP, you can directly report a bug by - creating a Jira issue at `ONAP Jira `_. - - * If you don't know you are facing a bug or have a question, post your - question into the - `Ask question `_. - You will need a Linux Foundation ID to login and post your question. - Get a Linux Foundation Identity using this - `quick procedure `_. - -To properly report a bug in Jira, you may want to consider these `recommendations `_ to elaborate the issue you are facing. - .. Include files referenced by link in the toctree as hidden - -.. toctree:: - :hidden: - - releaserepos.rst - repolist.rst