-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. This work is licensed under a Creative Commons Attribution 4.0
+ International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) ONAP Project and its contributors
-Release Notes
-=============
+*******************
+CCSDK Release Notes
+*******************
-Version: 0.2.2
---------------
+Abstract
+========
-:Release Date: 2018-06-07
-
-
-
-**New Features**
-
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| Jira # | Abstract |
-+=============+=====================================================================================================================+
-| [CCSDK-265] | SetNodeExecutor nulling feature enhancement <https://jira.onap.org/browse/CCSDK-265> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-238] | DGBuilder uploadXML displaying processing gif even after successful upload <https://jira.onap.org/browse/CCSDK-238> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-231] | remove most of pgaas repo <https://jira.onap.org/browse/CCSDK-231> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-227] | Simplify enumeration handling <https://jira.onap.org/browse/CCSDK-227> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-222] | Ansible server support <https://jira.onap.org/browse/CCSDK-222> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-214] | support enumerations containing whitespace <https://jira.onap.org/browse/CCSDK-214> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-211] | change reference of sdnc to ccsdk in dgbuilder-docker files <https://jira.onap.org/browse/CCSDK-211> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-210] | allow request body to be passed into rest api call node <https://jira.onap.org/browse/CCSDK-210> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-209] | read properties file using system property <https://jira.onap.org/browse/CCSDK-209> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-204] | svclogic loader improvements <https://jira.onap.org/browse/CCSDK-204> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-203] | restore previous behavior <https://jira.onap.org/browse/CCSDK-203> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-202] | additional logging and loading related changes <https://jira.onap.org/browse/CCSDK-202> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-193] | add timestamps to install log <https://jira.onap.org/browse/CCSDK-193> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-191] | enable fast loading of graphs <https://jira.onap.org/browse/CCSDK-191> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-190] | fix setnode null feature <https://jira.onap.org/browse/CCSDK-190> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-189] | favor interfaces over concrete classes <https://jira.onap.org/browse/CCSDK-189> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-187] | reset MDC after executing certain nodes <https://jira.onap.org/browse/CCSDK-187> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-181] | Want to use the dnsdesig plugin with recent OpenStack versions <https://jira.onap.org/browse/CCSDK-181> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-179] | Upgrade CCSDK ODL containers to Nitrogen <https://jira.onap.org/browse/CCSDK-179> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-177] | Upgrade sli/northbound to Nitrogen <https://jira.onap.org/browse/CCSDK-177> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-176] | Upgrade sli/adaptors to Nitrogen <https://jira.onap.org/browse/CCSDK-176> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-175] | Upgrade sli/core to Nitrogen <https://jira.onap.org/browse/CCSDK-175> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-174] | Update ccsdk parent to support Nitrogen parent poms <https://jira.onap.org/browse/CCSDK-174> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-172] | Ability to call Ansible playbook from directed graph <https://jira.onap.org/browse/CCSDK-172> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-158] | sliPluginUtils enhancements <https://jira.onap.org/browse/CCSDK-158> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-157] | Healthcheck enhancements <https://jira.onap.org/browse/CCSDK-157> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-156] | Fixes to logging filters package <https://jira.onap.org/browse/CCSDK-156> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-155] | Service Logic Interpreter improvements <https://jira.onap.org/browse/CCSDK-155> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-152] | Service Logic Compiler improvements <https://jira.onap.org/browse/CCSDK-152> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-151] | Address issues identified by sonar <https://jira.onap.org/browse/CCSDK-151> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-124] | minor pom changes <https://jira.onap.org/browse/CCSDK-124> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-123] | number of small improvements made in SLI <https://jira.onap.org/browse/CCSDK-123> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-122] | Modifying restapicallnode to support mocking and minor refactoring <https://jira.onap.org/browse/CCSDK-122> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-121] | Modifying sdnc-core to support mocking and minor refactoring <https://jira.onap.org/browse/CCSDK-121> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-111] | Refactor CCSDK/Dashboard project <https://jira.onap.org/browse/CCSDK-111> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-109] | Documentation for ccsdk/dashboard <https://jira.onap.org/browse/CCSDK-109> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-63] | Migrate all feature bundle to features-parent <https://jira.onap.org/browse/CCSDK-63> |
-+-------------+---------------------------------------------------------------------------------------------------------------------+
-
-**Bug Fixes**
-
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| Jira # | Abstract |
-+=============+==========================================================================================================================+
-| [CCSDK-277] | restapicallnode OSGI lookup fails <https://jira.onap.org/browse/CCSDK-277> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-276] | Ccsdk components not installing in odlsli docker image <https://jira.onap.org/browse/CCSDK-276> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-273] | Missing ansible-adapter.properties file causes NullPointerException <https://jira.onap.org/browse/CCSDK-273> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-272] | LCM API expects wrong names for DGs <https://jira.onap.org/browse/CCSDK-272> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-270] | Remove AT&T license from csar sample <https://jira.onap.org/browse/CCSDK-270> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-269] | Remove erroneous license header <https://jira.onap.org/browse/CCSDK-269> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-268] | SDNC Error on loading Preload in karaf.log <https://jira.onap.org/browse/CCSDK-268> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-264] | Missing EELF dependency in ansible-bundle <https://jira.onap.org/browse/CCSDK-264> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-261] | SO build failure because of artifact not available in ccsdk pom <https://jira.onap.org/browse/CCSDK-261> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-254] | UEB Listener failing <https://jira.onap.org/browse/CCSDK-254> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-252] | LCM returns rpc not registered <https://jira.onap.org/browse/CCSDK-252> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-251] | ansible-adapter install fails <https://jira.onap.org/browse/CCSDK-251> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-250] | update aaiclient properties in ccsdk/distribution <https://jira.onap.org/browse/CCSDK-250> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-248] | sli/adaptors release build fails <https://jira.onap.org/browse/CCSDK-248> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-247] | APPC receiving the trustAnchors parameter must be non-empty error in aai client <https://jira.onap.org/browse/CCSDK-247> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-246] | Add support for primary identifier of type int in XSD generated model <https://jira.onap.org/browse/CCSDK-246> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-244] | Remove unnecessary cast in SqlResource decryptColumn() <https://jira.onap.org/browse/CCSDK-244> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-243] | Precedence incorrect for properties search <https://jira.onap.org/browse/CCSDK-243> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-241] | Install karaf host key in ODL container <https://jira.onap.org/browse/CCSDK-241> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-237] | Directed graphs not installed in odlsli container <https://jira.onap.org/browse/CCSDK-237> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-236] | SvcLogicService does not recognize any DG node types <https://jira.onap.org/browse/CCSDK-236> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-235] | CCSDK container fails due to missing logback package <https://jira.onap.org/browse/CCSDK-235> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-234] | ccsdk docker container doesnt have correct version of logback <https://jira.onap.org/browse/CCSDK-234> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-230] | Code Coverage for sli-northbound <https://jira.onap.org/browse/CCSDK-230> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-229] | AAI-Service methods were removed that are still being used <https://jira.onap.org/browse/CCSDK-229> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-225] | Add Junits for Adaptors <https://jira.onap.org/browse/CCSDK-225> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-224] | Update oparent version <https://jira.onap.org/browse/CCSDK-224> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-220] | Add default constructor for SqlResource <https://jira.onap.org/browse/CCSDK-220> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-217] | CCSDK health check responds 501 <https://jira.onap.org/browse/CCSDK-217> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-216] | filters feature does not install <https://jira.onap.org/browse/CCSDK-216> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-215] | resource-assignment feature not installing <https://jira.onap.org/browse/CCSDK-215> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-213] | Code coverage on sli/core below 50% <https://jira.onap.org/browse/CCSDK-213> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-208] | Restart fails on odlsli container initialization <https://jira.onap.org/browse/CCSDK-208> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-207] | Incorrect spring version <https://jira.onap.org/browse/CCSDK-207> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-205] | update vnfapi provider class to support soft-delete <https://jira.onap.org/browse/CCSDK-205> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-200] | Enhance vnfapi yang model to include subnet-role and network-role-tag <https://jira.onap.org/browse/CCSDK-200> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-198] | platform/nbapi merge fails <https://jira.onap.org/browse/CCSDK-198> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-197] | Fix parent release build <https://jira.onap.org/browse/CCSDK-197> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-196] | CCSDK dashboard still using code from locked repos ecompsdkos <https://jira.onap.org/browse/CCSDK-196> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-192] | Update master detection for master/slave database configuration <https://jira.onap.org/browse/CCSDK-192> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-184] | Use cryptographically secure random number generation <https://jira.onap.org/browse/CCSDK-184> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-182] | Passwords stored in clear text in properties files <https://jira.onap.org/browse/CCSDK-182> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-171] | Convert aai-service provider to blueprint <https://jira.onap.org/browse/CCSDK-171> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-170] | Null pointer exception while executing test case after sonar issue fix. <https://jira.onap.org/browse/CCSDK-170> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-168] | Generalize sli-core/utils FileResolver dblib package <https://jira.onap.org/browse/CCSDK-168> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-154] | ccsdk/sli/northbound/dmaap-listener module compilation failure <https://jira.onap.org/browse/CCSDK-154> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
-| [CCSDK-137] | isolate deprecated methods <https://jira.onap.org/browse/CCSDK-137> |
-+-------------+--------------------------------------------------------------------------------------------------------------------------+
+This document provides the release notes for the Frankfurt release of the Common Controller Software
+Development Kit (CCSDK).
+
+Summary
+=======
+
+The Frankfurt release of CCSDK introduces new functionality to support PNFs (Physical Network Functions), extends support
+for Netconf/TLS to support CMPv2, and extends CDS to act as an agent in self-serve control loops.
-**Known Issues**
-+-------------+-----------------------------------------------------------------------------------------------------+
-| Jira # | Abstract |
-+=============+=====================================================================================================+
-| [CCSDK-136] | pgaas is dependent on location\_prefix being all lowercase <https://jira.onap.org/browse/CCSDK-136> |
-+-------------+-----------------------------------------------------------------------------------------------------+
+Release Data
+============
-**Security Notes**
++-------------------------+-------------------------------------------+
+| **Project** | CCSDK |
+| | |
++-------------------------+-------------------------------------------+
+| **Docker images** | See :ref:`dockercontainers` section below |
++-------------------------+-------------------------------------------+
+| **Release designation** | Frankfurt |
+| | |
++-------------------------+-------------------------------------------+
+| **Release date** | 06/04/2020 |
+| | |
++-------------------------+-------------------------------------------+
-CCSDK 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 CCSDK open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=28379011>`_.
-Quick Links:
- - `CCSDK project page <https://wiki.onap.org/display/DW/Common+Controller+SDK+Project>`_
-
- - `Passing Badge information for CCSDK <https://bestpractices.coreinfrastructure.org/en/projects/1630>`_
-
- - `Project Vulnerability Review Table for CCSDK <https://wiki.onap.org/pages/viewpage.action?pageId=28379011>`_
+New features
+------------
-**Upgrade Notes**
+The CCSDK Frankfurt release includes the following features:
-N/A
+* First phase of OpenDaylight separation (Jira `CCSDK-8 <https://jira.onap.org/browse/CCSDK-8>`_), currently targeted for completion in Guilin
+* Integration of CDS as an actor in Control loops (Jira `CCSDK-1898 <https://jira.onap.org/browse/CCSDK-1898>`_)
+* ORAN-compliant A1 adaptor (Jira `CCSDK-1796 <https://jira.onap.org/browse/CCSDK-1796>`_)
+* Multi-Domain Optical Service (Jira `CCSDK-1828 <https://jira.onap.org/browse/CCSDK-1828>`_)
+* Python 2 -> Python 3 migration (Jira `CCSDK-1905 <https://jira.onap.org/browse/CCSDK-1905>`_)
-**Deprecation Notes**
-N/A
+For the complete list of `CCSDK Frankfurt release epics <https://jira.onap.org/issues/?filter=12316>`_ and
+`CCSDK Frankfurt release user stories <https://jira.onap.org/issues/?filter=12319>`_ , please see the `ONAP Jira`_.
-**Other**
+**Bug fixes**
-N/A
+The full list of `bugs fixed in the CCSDK Frankfurt release <https://jira.onap.org/issues/?filter=12320>`_ is maintained on the `ONAP Jira`_.
+**Known Issues**
-Version: 0.1.0
+The full list of `known issues in CCSDK <https://jira.onap.org/issues/?filter=11341>`_ is maintained on the `ONAP Jira`_.
+
+Deliverables
+------------
+
+Software Deliverables
+~~~~~~~~~~~~~~~~~~~~~
+
+.. _dockercontainers:
+
+Docker Containers
+`````````````````
+
+The following table lists the docker containers comprising the CCSDK Frankfurt
+release along with the current stable Frankfurt version/tag. Each of these is
+available on the ONAP nexus3 site (https://nexus3.onap.org) and can be downloaded
+with the following command::
+
+ docker pull nexus3.onap.org:10001/{image-name}:{version}
+
+
+Note: users that want to use the latest in-development Frankfurt version may use the
+tag 0.7-STAGING-latest to pull the latest daily Frankfurt build
+
++-----------------------------------+--------------------------------------------+---------+
+| Image name | Description | Version |
++===================================+============================================+=========+
+| onap/ccsdk-alpine-image | Base Alpine Linux image for CCSDK | 0.7.3 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-ansible-server-image | Ansible server image | 0.7.3 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-apps-ms-neng | Naming microservice | 0.7.1 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-blueprints-processor | CDS blueprint processor | 0.7.2 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-cds-ui | CDS web interface | 0.7.2 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-cds-ui-server | CDS user interface back end | 0.7.2 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-commandexecutor | CDS command executor | 0.7.2 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-controllerblueprint | CDS controller blueprints | 0.7.2 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-dgbuilder-image | Directed graph builder | 0.7.2 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-odl-neon-alpine-image | Alpine based OpenDaylight Neon SR1 image | 0.7.3 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-odlsli-alpine-image | Alpine based OpenDaylight image with CCSDK | 0.7.3 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-saltstack-server-image | Saltstack server | 0.7.3 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-sdclistener | CDS SDC listener | 0.7.2 |
++-----------------------------------+--------------------------------------------+---------+
+| onap/ccsdk-ubuntu-image | Base Ubuntu image for CCSDK | 0.7.3 |
++-----------------------------------+--------------------------------------------+---------+
+
+Maven Artifacts
+```````````````
+In addition to docker containers, CCSDK also provides libraries that are intended to be used by
+client applications (e.g. APPC, SDNC) as maven dependencies.
+
+
+ccsdk/parent
+^^^^^^^^^^^^
+Many CCSDK clients need to be able to inherit settings from third party parent poms provided
+by OpenDaylight or springboot, and therefore are unable to use the standard ONAP parent pom.
+The CCSDK parent repository provides its own version of parent poms whose contents are consistent
+with ONAP standard settings (as defined in oparent), but whose parent is the OpenDaylight or
+springboot parent, so that clients can effectively merge both sets of settings.
+
+The following table lists the parent poms provided by CCSDK and the current stable
+Frankfurt version of each.
+
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| groupId | artifactId | version | Description |
++=======================+==============================+=========+==================================================================================================+
+| org.onap.ccsdk.parent | binding-parent | 1.5.4 | Parent used in place of OpenDaylight binding-parent |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | bundle-parent | 1.5.4 | Parent used in place of OpenDaylight bundle-parent |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | client-parent | 1.5.4 | Parent used for projects that create client libraries for OpenDaylight APIs |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | dependencies-bom | 1.5.4 | Bill of Materials POM that defines versions of third party libraries used outside ODL container. |
+| | | | Intended to be imported in dependencyManagement section. |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | dependencies-odl-bom | 1.5.4 | Bill of Materials POM that defines versions of third party libraries used within ODL container. |
+| | | | Intended to be imported in dependencyManagement section. |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | feature-repo-parent | 1.5.4 | Parent used in place of OpenDaylight feature-repo-parent |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | karaf4-parent | 1.5.4 | Parent used in place of OpenDaylight karaf4-parent |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | mdsal-it-parent | 1.5.4 | Parent used in place of OpenDaylight mdsal-it-parent |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | odlparent | 1.5.4 | Parent used in place of OpenDaylight odlparent |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | odlparent-lite | 1.5.4 | Parent used in place of OpenDaylight odlparent-lite |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | single-feature-parent | 1.5.4 | Parent used in place of OpenDaylight single-feature-parent |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | spring-boot-1-starter-parent | 1.5.4 | Parent used in place of spring-boot-starter-parent for Springboot 1.x. |
+| | | | *NOTE* This is deprecated and will be removed in Guilin, since springboot 1.x should no |
+| | | | longer be used due to security issues |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | spring-boot-starter-parent | 1.5.4 | Parent used in place of spring-boot-starter-parent for Springboot 2.x |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+| org.onap.ccsdk.parent | standalone-parent | 1.5.4 | Parent used for projects that have no need for other third party parent poms |
++-----------------------+------------------------------+---------+--------------------------------------------------------------------------------------------------+
+
+ccsdk/sli/core
+^^^^^^^^^^^^^^
+The ccsdk/sli/core library provides base functionality needed by the Service Logic Interpreter (SLI), which is the engine that runs directed graphs. It also
+provides a number of libraries that can be used by other CCSDK client projects.
+
+The following table lists the maven artifacts provided for use by CCSDK client
+projects.
+
++-------------------------+-------------------------+---------+--------------------------------------------+
+| groupId | artifactId | version | Description |
++=========================+=========================+=========+============================================+
+| org.onap.ccsdk.sli.core | dblib-provider | 0.7.2 | Database access library |
++-------------------------+-------------------------+---------+--------------------------------------------+
+| org.onap.ccsdk.sli.core | sli-common | 0.7.2 | Common SLI data objects |
++-------------------------+-------------------------+---------+--------------------------------------------+
+| org.onap.ccsdk.sli.core | sli-provider-base | 0.7.2 | ODL-independent SLI implementation objects |
++-------------------------+-------------------------+---------+--------------------------------------------+
+| org.onap.ccsdk.sli.core | sli-provider | 0.7.2 | ODL-dependent SLI implementation objects |
++-------------------------+-------------------------+---------+--------------------------------------------+
+| org.onap.ccsdk.sli.core | sliPluginUtils-provider | 0.7.2 | Utilities for use in SLI adaptors/plugins |
++-------------------------+-------------------------+---------+--------------------------------------------+
+| org.onap.ccsdk.sli.core | utils-provider | 0.7.2 | Utilities |
++-------------------------+-------------------------+---------+--------------------------------------------+
+
+ccsdk/sli/adaptors
+^^^^^^^^^^^^^^^^^^
+The ccsdk/sli/adaptors library provides interface adaptors meant to be used in resource nodes in directed graphs.
+
+The following table lists the maven artifacts provided for use by CCSDK client
+projects.
+
++-----------------------------+------------------------------+---------+--------------------------------+
+| groupId | artifactId | version | Description |
++=============================+==============================+=========+================================+
+| org.onap.ccsdk.sli.adaptors | aai-service-provider | 0.7.2 | A&AI interface adaptor |
++-----------------------------+------------------------------+---------+--------------------------------+
+| org.onap.ccsdk.sli.adaptors | ansible-adapter-bundle | 0.7.2 | Ansible interface adaptor |
++-----------------------------+------------------------------+---------+--------------------------------+
+| org.onap.ccsdk.sli.adaptors | mdsal-resource-provider | 0.7.2 | MD-SAL interface adaptor |
++-----------------------------+------------------------------+---------+--------------------------------+
+| org.onap.ccsdk.sli.adaptors | netbox-client-provider | 0.7.2 | netbox interface adaptor |
++-----------------------------+------------------------------+---------+--------------------------------+
+| org.onap.ccsdk.sli.adaptors | resource-assignment-provider | 0.7.2 | resource allocator |
++-----------------------------+------------------------------+---------+--------------------------------+
+| org.onap.ccsdk.sli.adaptors | saltstack-adaptor-provider | 0.7.2 | saltstack interface adaptor |
++-----------------------------+------------------------------+---------+--------------------------------+
+| org.onap.ccsdk.sli.adaptors | sql-resource-provider | 0.7.2 | SQL database interface adaptor |
++-----------------------------+------------------------------+---------+--------------------------------+
+
+ccsdk/sli/northbound
+^^^^^^^^^^^^^^^^^^^^
+The ccsdk/sli/northbound library contains the code for northbound interfaces which typically invoke
+the SLI.
+
+The following table lists the maven artifacts provided for use by CCSDK client projects.
+
++-------------------------------+---------------------+---------+-----------------------------------------+
+| groupId | artifactId | version | Description |
++===============================+=====================+=========+=========================================+
+| org.onap.ccsdk.sli.northbound | asdcApi-provider | 0.7.2 | ODL-based SDC interface |
++-------------------------------+---------------------+---------+-----------------------------------------+
+| org.onap.ccsdk.sli.northbound | dataChange-provider | 0.7.2 | A&AI data change notification interface |
++-------------------------------+---------------------+---------+-----------------------------------------+
+| org.onap.ccsdk.sli.northbound | dmaap-listener | 0.7.2 | DMaaP listener interface |
++-------------------------------+---------------------+---------+-----------------------------------------+
+| org.onap.ccsdk.sli.northbound | lcm-provider | 0.7.2 | Life Cycle Management event interface |
++-------------------------------+---------------------+---------+-----------------------------------------+
+| org.onap.ccsdk.sli.northbound | ueb-listener | 0.7.2 | SDC event listener |
++-------------------------------+---------------------+---------+-----------------------------------------+
+
+ccsdk/sli/plugins
+^^^^^^^^^^^^^^^^^
+The ccsdk/sli/northbound library contains the code for plugins meant to be called from an 'execute' node
+in a directed graph.
+
+The following table lists the maven artifacts provided for use by CCSDK client projects.
+
++----------------------------+----------------------------+---------+-------------------------------------------------------+
+| groupId | artifactId | version | Description |
++============================+============================+=========+=======================================================+
+| org.onap.ccsdk.sli.plugins | properties-node-provider | 0.7.2 | Used to load a properties file for use in |
+| | | | a directed graph |
++----------------------------+----------------------------+---------+-------------------------------------------------------+
+| org.onap.ccsdk.sli.plugins | restapi-call-node-provider | 0.7.2 | Used to call a generic REST API from a directed |
+| | | | graph |
++----------------------------+----------------------------+---------+-------------------------------------------------------+
+| org.onap.ccsdk.sli.plugins | restconf-client-provider | 0.7.2 | Used to call a RESTCONF API from a directed graph |
++----------------------------+----------------------------+---------+-------------------------------------------------------+
+| org.onap.ccsdk.sli.plugins | sshapi-call-node | 0.7.2 | Used to invoke an SSH interface from a directed graph |
++----------------------------+----------------------------+---------+-------------------------------------------------------+
+| org.onap.ccsdk.sli.plugins | template-node-provider | 0.7.2 | Provides velocity template support |
++----------------------------+----------------------------+---------+-------------------------------------------------------+
+
+Documentation Deliverables
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+* `CDS user guide`_
+* `SDN Controller for Radio user guide`_
+* `ccsdk/sli/core Javadoc`_
+* `ccsdk/sli/adaptors Javadoc`_
+* `ccsdk/sli/northbound Javadoc`_
+* `ccsdk/sli/plugins Javadoc`_
+
+Known Limitations, Issues and Workarounds
+=========================================
+
+System Limitations
+------------------
+
+No system limitations noted.
+
+
+Known Vulnerabilities
+---------------------
+
+Any known vulnerabilities for ONAP are tracked in the `ONAP Jira`_ in the OJSI project. Any outstanding OJSI issues that
+pertain to CCSDK are listed in the :ref:`secissues` section below.
+
+
+Workarounds
+-----------
+
+Not applicable.
+
+
+Security Notes
--------------
+Fixed Security Issues
+~~~~~~~~~~~~~~~~~~~~~
-:Release Date: 2017-11-16
+The following security issues have been addressed in the Frankfurt CCSDK release:
+* `OSJI-197 <https://jira.onap.org/browse/OJSI-197>`_ : cds-blueprints-processor-http exposes plain text HTTP endpoint using port 30499
+* `CCSDK-2149 <https://jira.onap.org/browse/CCSDK-2149>`_ : Pods still run as root
+* `CCSDK-1910 <https://jira.onap.org/browse/CCSDK-1910>`_ : Password removal from OOM Helm charts
+With these fixes, CCSDK no longer exposes any external http ports and no CCSDK pod runs as root.
-**New Features**
+.. _secissues :
-The Common Controller SDK provides the following functionality :
- - Service Logic Interpreter
- - Database access library (dblib)
- - Service Logic test api (sliapi)
- - MD-SAL data query adaptor
- - SQL query adaptor
- - Resource allocator
- - SDC interface
- - DMAAP interface
- - REST API adaptor
+Known Security Issues
+~~~~~~~~~~~~~~~~~~~~~
+There is currently only one known CCSDK security issue, related to a third party application (netbox) that CCSDK uses:
-**Bug Fixes**
+* `OJSI-160 <https://jira.onap.org/browse/OJSI-160>`_ : netbox-nginx exposes plain text HTTP endpoint using port 30420
-**Known Issues**
- - `CCSDK-110 <https://jira.onap.org/browse/CCSDK-110>`_ Resolve license issues in dashboard project
- - `CCSDK-136 <https://jira.onap.org/browse/CCSDK-136>`_ pgaas is dependent on location_prefix being all lowercase
- - `CCSDK-137 <https://jira.onap.org/browse/CCSDK-137>`_ isolate deprecated methods
-**Security Issues**
- You may want to include a reference to CVE (Common Vulnerabilities and Exposures) `CVE <https://cve.mitre.org>`_
+Test Results
+============
+Not applicable
+
+
+References
+==========
-**Upgrade Notes**
+For more information on the ONAP Frankfurt release, please see:
-**Deprecation Notes**
+#. `ONAP Home Page`_
+#. `ONAP Documentation`_
+#. `ONAP Release Downloads`_
+#. `ONAP Wiki Page`_
-**Other**
+.. _`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
+.. _`ONAP Jira`: https://jira.onap.org
+.. _`CDS user guide`: https://docs.onap.org/en/frankfurt/submodules/ccsdk/cds.git/docs/index.html
+.. _`SDN Controller for Radio user guide`: https://docs.onap.org/en/frankfurt/submodules/ccsdk/features.git/docs/guides/onap-user/home.html
+.. _`ccsdk/sli/core Javadoc`: https://nexus.onap.org/service/local/repositories/javadoc/content/org.onap.ccsdk/sli/core/frankfurt/index.html
+.. _`ccsdk/sli/adaptors Javadoc`: https://nexus.onap.org/service/local/repositories/javadoc/content/org.onap.ccsdk/sli/adaptors/frankfurt/index.html
+.. _`ccsdk/sli/northbound Javadoc`: https://nexus.onap.org/service/local/repositories/javadoc/content/org.onap.ccsdk/sli/northbound/frankfurt/index.html
+.. _`ccsdk/sli/plugins Javadoc`: https://nexus.onap.org/service/local/repositories/javadoc/content/org.onap.ccsdk/sli/plugins/frankfurt/index.html
Code Review / ccsdk / distribution.git / blobdiff