docs/release/index.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0
   2    International License. http://creativecommons.org/licenses/by/4.0
   3
   4 Casablanca Release Notes
   5 ^^^^^^^^^^^^^^^^^^^^^^^^
   6 This page is the ONAP Casablanca Release Notes. The first release was labelled
   7 Amsterdam, second release Beijing and subsequent major release will be named
   8 using city names.
   9
  10 * Release Name: Casablanca
  11 * Release Version: 3.0.0
  12 * Release Date: Nov 30, 2018
  13
  14
  15 Getting Started With ONAP
  16 =========================
  17
  18 Summary
  19 -------
  20 ONAP provides a comprehensive platform for real-time, policy-driven
  21 service orchestration and automation including virtual network functions and
  22 applications instantiation and configuration, but also physical network
  23 functions configuration.
  24 ONAP will enable software, network, IT and cloud providers and developers
  25 to rapidly automate new services and support complete life cycle management.
  26 By unifying member resources, ONAP will accelerate the development of a
  27 vibrant ecosystem around a globally shared architecture and implementation
  28 for network automation-with an open standards focus-faster than any one
  29 product could on its own.
  30
  31 Functionality
  32 -------------
  33 **Portal** - a single, consistent user experience for both design time
  34 and run time environments, based on the user’s role.
  35
  36 **Design Time Framework** - a comprehensive development environment with
  37 tools, techniques, and repositories for defining/describing resources,
  38 and services:
  39
  40  - Service Design and Creation (SDC) provides tools, techniques, and
  41    repositories to define/simulate/certify system assets as well as their
  42    associated processes and policies.
  43
  44  - A VNF Software Development Kit (VNFSDK) and VNF Validation Program (VVP)
  45    with tools for VNF supplier packaging and validation.
  46
  47  - Policy Creation (POLICY) deals with conditions, requirements,
  48    constraints, attributes, or needs that must be provided, maintained,
  49    and/or enforced.
  50
  51  - Closed Loop Automation Management Platform (CLAMP) provides a method
  52    for designing and managing control loops.
  53
  54  - Optimization Framework (OOF) provides a policy-driven and model-driven
  55    framework for creating optimization applications.
  56
  57 **Runtime Framework** - The runtime execution framework executes the
  58 rules and policies distributed by the design and creation environment
  59 and Controllers that manage resources corresponding to their assigned
  60 controlled domain:
  61
  62  - Service Orchestrator (SO) executes the specified BPMN processes and
  63    automates sequences of activities, tasks, rules and policies needed for
  64    on-demand creation, modification or removal of network, application or
  65    infrastructure services and resources. SO is especially able to drive
  66    any OpenStack-based cloud platform.
  67
  68  - Software Defined Network Controller (SDNC) executes network configuration
  69    for cloud computing resources and network.
  70
  71  - Application Controller (APPC) executes Virtual Network Functions (VNF)
  72    configurations and lifecycle management operations.
  73
  74  - Virtual Function Controller (VF-C) is responsible for lifecycle management
  75    of virtual network functions and network services based on VNF using
  76    VNF Manager.
  77
  78  - Active and Available Inventory (A&AI) provides real-time views of a
  79    system’s resources, services, products and their relationships with each
  80    other.
  81
  82 **Closed-Loop Automation** -- Design -> Create -> Collect -> Analyze >
  83 Detect -> Publish -> Respond:
  84
  85  - Data Collection, Analytics and Events (DCAE) collects events, performance,
  86    usage and publishes information to policy that executes the rules to perform
  87    closed loop actions.
  88
  89  - Holmes provides alarm correlation and analysis for Telecom cloud
  90    infrastructure and services, including servers, cloud infrastructure,
  91    VNFs and Network Services.
  92
  93  - Common Services - operational services for all ONAP components including
  94    activity logging, reporting, common data layer, access control, resiliency,
  95    multisite state coordination, credential/secret management and
  96    software lifecycle management.
  97
  98 **Microservices Support**
  99
 100  - ONAP Operation Manager (OOM) use Kubernetes and Helm to manage ONAP
 101    components.
 102  - Microservices Bus (MSB) provides service registration/discovery,
 103    external API gateway, internal API gateway, client software development kit
 104    (SDK), and Swagger SDK.
 105
 106 Project Specific Release Notes
 107 ==============================
 108 ONAP releases are specified by a list of project artifact
 109 versions in a :ref:`manifest<doc-release-manifest>`.
 110
 111 Each project provides detailed :ref:`release notes<doc-releaserepos>`
 112 and prepends to these if/when any updated versions the project team believes
 113 are compatible with a major release are made available.
 114
 115 .. index:: Download
 116
 117 Installation
 118 ============
 119 ONAP is installed using
 120 :ref:`ONAP Operations Manager (OOM) over Kubernetes<installing-onap>`
 121
 122 Documentation
 123 =============
 124 ONAP Casablanca Release provides multiple documents including the following:
 125
 126  * A high level :ref:`architecture view<doc-architecture>` of how components
 127    relate to each other.
 128
 129  * A collection of documentation provided
 130    by :ref:`each project <doc_onap-developer_guide_projects>`.
 131
 132  * Application Programming Interface
 133    Reference :ref:`available here <doc-apiref>`.
 134
 135  * The `developer wiki <http://wiki.onap.org>`_ remains a good source of
 136    information on meeting plans and notes from committees, project teams and
 137    community events.
 138
 139 .. index:: Licensing
 140
 141 Security Notes
 142 ==============
 143 ONAP has adopted the
 144 `CII Best Practice Badge Program <https://bestpractices.coreinfrastructure.org/en>`_.
 145 The goal of the Casablanca release is for all ONAP projects to be close to
 146 achieving a CII Passing badge.
 147
 148 - `Badging Requirements <https://github.com/coreinfrastructure/best-practices-badge#core-infrastructure-initiative-best-practices-badge>`_
 149 - `Badging Status for all ONAP projects <https://bestpractices.coreinfrastructure.org/en/projects?q=onap>`_
 150
 151 Project specific details are in the :ref:`release notes<doc-releaserepos>`
 152 for each project.
 153
 154 .. index:: maturity
 155
 156 ONAP Maturity Testing Notes
 157 ===========================
 158 For the Casablanca release, ONAP continues to improve in multiple areas of
 159 Scalability, Security, Stability and Performance (S3P) metrics.
 160
 161 The Integration team ran the 72 hours stability testing (100% passing rate)
 162 and full resilience testing (96.9% passing rate) at ONAP OpenLabs. More details in :ref:`ONAP Maturity Testing Notes <integration-s3p>`
 163
 164 Licenses
 165 ========
 166 ONAP Source Code is licensed under the `Apache Version 2 License
 167 <http://www.apache.org/licenses/LICENSE-2.0>`_.
 168 ONAP Documentation is licensed under the `Creative Commons Attribution 4.0
 169 International License <http://creativecommons.org/licenses/by/4.0>`_.
 170
 171 Known Issues and Limitations
 172 ============================
 173 Known Issues and limitations are documented in each
 174 :ref:`project Release Notes <doc-releaserepos>`.
 175
 176 .. index:: Reporting Bugs
 177
 178 How to Report a Bug
 179 ===================
 180 There are 2 ways to report a bug in ONAP.
 181
 182  * In case you are familiar within ONAP, you can directly report a bug by
 183    creating a Jira issue at `ONAP Jira <https://jira.onap.org>`_.
 184
 185  * If you don't know you are facing a bug or have a question, post your
 186    question into the
 187    `Ask question <https://wiki.onap.org/display/DW/questions/all>`_.
 188    You will need a Linux Foundation ID to login and post your question.
 189    Get a Linux Foundation Identity using this
 190    `quick procedure <https://wiki.onap.org/display/DW/Joining+the+ONAP+Technical+Community#JoiningtheONAPTechnicalCommunity-WhereDoIStart?>`_.
 191
 192 To properly report a bug in Jira, you may want to consider these `recommendations <https://wiki.onap.org/display/DW/Tracking+Issues+with+JIRA#TrackingIssueswithJIRA-RecommendationsforwrittingProperJIRAIssue>`_ to elaborate the issue you are facing.
 193
 194
 195 .. Include files referenced by link in the toctree as hidden
 196
 197 .. toctree::
 198    :hidden:
 199
 200    release-manifest.rst
 201    releaserepos.rst
 202    repolist.rst