.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. _policy-release-notes:
Policy Release Notes
====================
.. * one section describing the purpose of this new release.
.. * This note must be removed after content has been added.
+.. ===========================
+.. * * * FRANKFURT * * *
+.. ===========================
+
+Abstract
+========
+
+This document provides the release notes for the Frankfurt release.
+
+Summary
+=======
+
+
+Release Data
+============
+
++--------------------------------------+--------------------------------------+
+| **Policy Project** | |
+| | |
++--------------------------------------+--------------------------------------+
+| **Docker images** | - policy-api 2.2.0 |
+| | - policy-pap 2.2.0 |
+| | - policy-drools-pdp 1.6.0 |
+| | - policy-xacml-pdp 2.2.0 |
+| | - policy-apex-pdp 2.3.0 |
+| | - policy-distribution 2.3.0 |
+| | - policy-pe 1.6.1 |
+| | |
++--------------------------------------+--------------------------------------+
+| **Release designation** | 6.0.0 frankfurt |
+| | |
++--------------------------------------+--------------------------------------+
+| **Release date** | 2020-05-07 (TBD) |
+| | |
++--------------------------------------+--------------------------------------+
+
+
+New features
+------------
+
+
+
+Known Limitations, Issues and Workarounds
+=========================================
+
+System Limitations
+------------------
+
+
+Known Vulnerabilities
+---------------------
+
+
+Workarounds
+-----------
+
+
+Security Notes
+--------------
+
+
+References
+==========
+
+For more information on the ONAP Frankfurt 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:
+ - `POLICY project page`_
+ - `Passing Badge information for POLICY`_
+
.. ==========================
.. * * * EL ALTO * * *
.. ==========================
-Version: 5.0.0
+Version: 5.0.1
--------------
-:Release Date: 2019-08-12 (El Alto Release)
+:Release Date: 2019-10-24 (El Alto Release)
**New Features**
:header: "Repository", "Java Artifact", "Docker Image (if applicable)"
:widths: 15,10,10
- "policy/parent", "3.0.0", ""
- "policy/common", "1.5.0", ""
- "policy/models", "2.1.2", ""
- "policy/api", "2.1.1", "onap/policy-api:2.1.1"
- "policy/pap", "2.1.1", "onap/policy-pap:2.1.1"
- "policy/drools-pdp", "1.5.1", "onap/policy-drools:1.5.1"
+ "policy/parent", "3.0.1", ""
+ "policy/common", "1.5.2", ""
+ "policy/models", "2.1.4", ""
+ "policy/api", "2.1.2", "onap/policy-api:2.1.2"
+ "policy/pap", "2.1.2", "onap/policy-pap:2.1.2"
+ "policy/drools-pdp", "1.5.2", "onap/policy-drools:1.5.2"
"policy/apex-pdp", "2.2.1", "onap/policy-apex-pdp:2.2.1"
- "policy/xacml-pdp", "2.1.1", "onap/policy-xacml-pdp:2.1.1"
- "policy/drools-applications", "1.5.1", "onap/policy-pdpd-cl:1.5.1"
- "policy/engine", "1.5.1", "onap/policy-pe:1.5.1"
- "policy/distribution", "2.2.0", "onap/policy-distribution:2.2.0"
+ "policy/xacml-pdp", "2.1.2", "onap/policy-xacml-pdp:2.1.2"
+ "policy/drools-applications", "1.5.3", "onap/policy-pdpd-cl:1.5.3"
+ "policy/engine", "1.5.2", "onap/policy-pe:1.5.2"
+ "policy/distribution", "2.2.1", "onap/policy-distribution:2.2.1"
"policy/docker", "1.4.0", "onap/policy-common-alpine:1.4.0 onap/policy/base-alpine:1.4.0"
The El Alto release for POLICY delivered the following Epics. For a full list of stories and tasks delivered in the El Alto release, refer to `JiraPolicyElAlto`_.
* [POLICY-1727] - This epic covers technical debt left over from Dublin
- POLICY-969 Docker improvement in policy framwork modules
+ - POLICY-1074 Fix checkstyle warnings in every repository
- POLICY-1121 RPM build for Apex
- POLICY-1223 CII Silver Badging Requirements
- - POLICY-1465 Support configurable Heap Memory Settings for JVM processes
+ - POLICY-1600 Clean up hash code equality checks, cloning and copying in policy-models
- POLICY-1646 Replace uses of getCanonicalName() with getName()
- - POLICY-1653 Remove isNullVersion() method
+ - POLICY-1652 Move PapRestServer to policy/common
- POLICY-1732 Enable maven-checkstyle-plugin in apex-pdp
- POLICY-1737 Upgrade oParent 2.0.0 - change daily jobs to staging jobs
- POLICY-1742 Make HTTP return code handling configurable in APEX
+ - POLICY-1743 Make URL configurable in REST Requestor and REST Client
- POLICY-1744 Remove topic.properties and incorporate into overall properties
- POLICY-1770 PAP REST API for PDPGroup Healthcheck
- POLICY-1771 Boost policy/api JUnit code coverage
+ - POLICY-1772 Boost policy/xacml-pdp JUnit code coverage
- POLICY-1773 Enhance the policy/xacml-pdp S3P Stability and Performance tests
- POLICY-1784 Better Handling of "version" field value with clients
- POLICY-1785 Deploy same policy with a new version simply adds to the list
+ - POLICY-1786 Create a simple way to populate the guard database for testing
- POLICY-1791 Address Sonar issues in new policy repos
- POLICY-1795 PAP: bounced apex and xacml pdps show deleted instance in pdp status through APIs.
- POLICY-1800 API|PAP components use different version formats
- POLICY-1805 Build up stability test for api component to follow S3P requirements
- POLICY-1806 Build up S3P performance test for api component
- - POLICY-1826 Move the dmaap and pdp simulator to policy/common
+ - POLICY-1847 Add control loop coordination as a preloaded policy type
+ - POLICY-1871 Change policy/distribution to support ToscaPolicyType & ToscaPolicy
+ - POLICY-1881 Upgrade policy/distribution to latest SDC artifacts
- POLICY-1885 Apex-pdp: Extend CLIEditor to generate policy in ToscaServiceTemplate format
+ - POLICY-1898 Move apex-pdp & distribution documents to policy/parent
+ - POLICY-1942 Boost policy/apex-pdp JUnit code coverage
+ - POLICY-1953 Create addTopic taking BusTopicParams instead of Properties in policy/endpoints
+
+ * Additional items delivered with the release.
+ - POLICY-1637 Remove "version" from PdpGroup
+ - POLICY-1653 Remove isNullVersion() method
+ - POLICY-1966 Fix more sonar issues in policy drools
+ - POLICY-1988 Generate El Alto AAF Certificates
* [POLICY-1823] - This epic covers the work to develop features that will be deployed dark in El Alto.
- POLICY-1762 Create CDS API model implementation
+ - POLICY-1763 Create CDS Actor
+ - POLICY-1899 Update optimization xacml application to support more flexible Decision API
+ - POLICY-1911 XACML PDP must be able to retrieve Policy Type from API
+
**Bug Fixes**
The following bug fixes have been deployed with this release:
- - POLICY-1793 API|MODELS: Retrieving Legacy Operational Policy as a Tosca Policy with wrong version
- - POLICY-1801 Deploy/undeploy via integer version fails
- - POLICY-1802 Apex-pdp: context album is mandatory for policy model to compile
- - POLICY-1803 PAP should undeploy policies when subgroup is deleted
- - POLICY-1808 API|PAP|PDP-X [new] should publish docker images with the following tag X.Y-SNAPSHOT-latest
- - POLICY-1809 In the return of GET call to retrieve the >1 version of guard policy, "version" field is always "1.0.0"
- - POLICY-1818 APEX does not allow arbitrary Kafka parameters to be specified
- - POLICY-1830 Policy throws error parsing its Publish on APPC-CL topic
- - POLICY-1838 Drools-pdp error log is missing data in ErrorDescription field
- - POLICY-1839 Policy Model currently needs to be escaped
- - POLICY-1842 Fix documentation links
- - POLICY-1843 Decision API not returning monitoring policies when calling api with policy-type
- - POLICY-1844 XACML PDP does not update policy statistics
- - POLICY-1859 Drools rules should not timeout when given timeout=0 - should be treated as infinite
- - POLICY-1872 brmsgw fails building a jar - trafficgenerator dependency does not exist
- - POLICY-1876 ONAP-PAP-REST JUnit fail on Centos
- - POLICY-1879 ApexPDP - Build/Test fails in Nordix - InetAddress.getLocalHost() fails
+ * `[POLICY-1671] <https://jira.onap.org/browse/POLICY-1671>`_ - policy/engine JUnit tests now take over 30 minutes to run
+ * `[POLICY-1725] <https://jira.onap.org/browse/POLICY-1725>`_ - XACML PDP returns 500 vs 400 for bad syntax JSON
+ * `[POLICY-1793] <https://jira.onap.org/browse/POLICY-1793>`_ - API|MODELS: Retrieving Legacy Operational Policy as a Tosca Policy with wrong version
+ * `[POLICY-1795] <https://jira.onap.org/browse/POLICY-1795>`_ - PAP: bounced apex and xacml pdps show deleted instance in pdp status through APIs.
+ * `[POLICY-1800] <https://jira.onap.org/browse/POLICY-1800>`_ - API|PAP components use different version formats
+ * `[POLICY-1802] <https://jira.onap.org/browse/POLICY-1802>`_ - Apex-pdp: context album is mandatory for policy model to compile
+ * `[POLICY-1803] <https://jira.onap.org/browse/POLICY-1803>`_ - PAP should undeploy policies when subgroup is deleted
+ * `[POLICY-1807] <https://jira.onap.org/browse/POLICY-1807>`_ - Latest version is always returned when using the endpoint to retrieve all versions of a particular policy
+ * `[POLICY-1808] <https://jira.onap.org/browse/POLICY-1808>`_ - API|PAP|PDP-X [new] should publish docker images with the following tag X.Y-SNAPSHOT-latest
+ * `[POLICY-1810] <https://jira.onap.org/browse/POLICY-1810>`_ - API: support "../deployed" REST API (URLs) for legacy policies
+ * `[POLICY-1811] <https://jira.onap.org/browse/POLICY-1811>`_ - The endpoint of retrieving the latest version of TOSCA policy does not return the latest one, especially when there are double-digit versions
+ * `[POLICY-1818] <https://jira.onap.org/browse/POLICY-1818>`_ - APEX does not allow arbitrary Kafka parameters to be specified
+ * `[POLICY-1838] <https://jira.onap.org/browse/POLICY-1838>`_ - Drools-pdp error log is missing data in ErrorDescription field
+ * `[POLICY-1839] <https://jira.onap.org/browse/POLICY-1839>`_ - Policy Model currently needs to be escaped
+ * `[POLICY-1843] <https://jira.onap.org/browse/POLICY-1843>`_ - Decision API not returning monitoring policies when calling api with policy-type
+ * `[POLICY-1844] <https://jira.onap.org/browse/POLICY-1844>`_ - XACML PDP does not update policy statistics
+ * `[POLICY-1858] <https://jira.onap.org/browse/POLICY-1858>`_ - Usecase DRL - named query should not be invoked
+ * `[POLICY-1859] <https://jira.onap.org/browse/POLICY-1859>`_ - Drools rules should not timeout when given timeout=0 - should be treated as infinite
+ * `[POLICY-1872] <https://jira.onap.org/browse/POLICY-1872>`_ - brmsgw fails building a jar - trafficgenerator dependency does not exist
+ * `[POLICY-2047] <https://jira.onap.org/browse/POLICY-2047>`_ - TOSCA Policy Types should be map not a list
+ * `[POLICY-2060] <https://jira.onap.org/browse/POLICY-2060>`_ - ToscaProperties object is missing metadata field
+ * `[POLICY-2156] <https://jira.onap.org/browse/POLICY-2156>`_ - missing field in create VF module request to SO
+
**Security Notes**
*Fixed Security Issues*
+
+ * `[POLICY-2115] <https://jira.onap.org/browse/POLICY-2115>`_ - Upgrade org.jgroups : jgroups : 4.0.12.Final
+ * `[POLICY-2084] <https://jira.onap.org/browse/POLICY-2084>`_ - Investigate pip (py2.py3-none-any) 9.0.1 (.whl) in apex-pdp
+ * `[POLICY-2072] <https://jira.onap.org/browse/POLICY-2072>`_ - Upgrade io.netty : netty-codec-http2 and netty-common to 4.1.39.Final
+ * `[POLICY-2005] <https://jira.onap.org/browse/POLICY-2005>`_ - Upgrade elastic search to 6.8.2
+ * `[POLICY-2001] <https://jira.onap.org/browse/POLICY-2001>`_ - Upgrade com.thoughtworks.xstream to 1.4.11.1
+ * `[POLICY-2000] <https://jira.onap.org/browse/POLICY-2000>`_ - Upgrade oparent 2.1.0-SNAPSHOT - to pull in jetty server to 9.4.20.v20190813
+ * `[POLICY-1999] <https://jira.onap.org/browse/POLICY-1999>`_ - Upgrade to httpcomponents httpclient 4.5.9
+ * `[POLICY-1598] <https://jira.onap.org/browse/POLICY-1598>`_ - mariadb container is outdated
+ * `[POLICY-1597] <https://jira.onap.org/browse/POLICY-1597>`_ - nexus container is outdated
+
*Known Security Issues*
*Known Vulnerabilities in Used Modules*
The following known issues will be addressed in a future release:
-POLICY-1276 JRuby interpreter shutdown fails on second and subsequent runs
-POLICY-1291 Maven Error when building Apex documentation in Windows
-POLICY-1725 XACML PDP returns 500 vs 400 for bad syntax JSON
-POLICY-1832 API|PAP: data race condition seem to appear sometimes when creating and deploying policy
+ * `[POLICY-1276] <https://jira.onap.org/browse/POLICY-1276>`_ - JRuby interpreter shutdown fails on second and subsequent runs
+ * `[POLICY-1291] <https://jira.onap.org/browse/POLICY-1291>`_ - Maven Error when building Apex documentation in Windows
+ * `[POLICY-1578] <https://jira.onap.org/browse/POLICY-1578>`_ - PAP pushPolicies.sh in startup fails due to race condition in some environments
+ * `[POLICY-1832] <https://jira.onap.org/browse/POLICY-1832>`_ - API|PAP: data race condition seem to appear sometimes when creating and deploying policy
+ * `[POLICY-2103] <https://jira.onap.org/browse/POLICY-2103>`_ - policy/distribution may need to re-synch if SDC gets reinstalled
+ * `[POLICY-2062] <https://jira.onap.org/browse/POLICY-2062>`_ - APEX PDP logs > 4G filled local storage
+ * `[POLICY-2080] <https://jira.onap.org/browse/POLICY-2080>`_ - drools-pdp JUnit fails intermittently in feature-active-standby-management
+ * `[POLICY-2111] <https://jira.onap.org/browse/POLICY-2111>`_ - PDP-D APPS: AAF Cadi conflicts with Aether libraries
+ * `[POLICY-2158] <https://jira.onap.org/browse/POLICY-2158>`_ - PAP loses synchronization with PDPs
+ * `[POLICY-2159] <https://jira.onap.org/browse/POLICY-2159>`_ - PAP console (legacy): cannot edit policies with GUI
.. ==========================
- For vLBS Use Case, the following steps are required to setup the service instance:
- Create a Service Instance via VID.
- Create a VNF Instance via VID.
- - Preload SDNC with topology data used for the actual VNF instantiation (both base and DNS scaling modules). NOTE: you may want to set “vlb_name_0” in the base VF module data to something unique. This is the vLB server name that DCAE will pass to Policy during closed loop. If the same name is used multiple times, the Policy name-query to AAI will show multiple entries, one for each occurrence of that vLB VM name in the OpenStack zone. Note that this is not a limitation, typically server names in a domain are supposed to be unique.
- - Instantiate the base VF module (vLB, vPacketGen, and one vDNS) via VID. NOTE: The name of the VF module MUST start with ``Vfmodule_``. The same name MUST appear in the SDNC preload of the base VF module topology. We’ll relax this naming requirement for Beijing Release.
- - Run heatbridge from the Robot VM using ``Vfmodule_`` … as stack name (it is the actual stack name in OpenStack)
+ - Preload SDNC with topology data used for the actual VNF instantiation (both base and DNS scaling modules). NOTE: you may want to set "vlb_name_0" in the base VF module data to something unique. This is the vLB server name that DCAE will pass to Policy during closed loop. If the same name is used multiple times, the Policy name-query to AAI will show multiple entries, one for each occurrence of that vLB VM name in the OpenStack zone. Note that this is not a limitation, typically server names in a domain are supposed to be unique.
+ - Instantiate the base VF module (vLB, vPacketGen, and one vDNS) via VID. NOTE: The name of the VF module MUST start with ``Vfmodule_``. The same name MUST appear in the SDNC preload of the base VF module topology. We'll relax this naming requirement for Beijing Release.
+ - Run heatbridge from the Robot VM using ``Vfmodule_`` _ as stack name (it is the actual stack name in OpenStack)
- Populate AAI with a dummy VF module for vDNS scaling.
**Security Issues**
.. note
.. CHANGE HISTORY
+.. 09/19/2019 - Updated for El Alto Release.
.. 05/16/2019 - Updated for Dublin Release.
.. 01/17/2019 - Updated for Casablanca Maintenance Release.
.. 11/19/2018 - Updated for Casablanca. Also, fixed bugs is a list of bugs where the "Affected Version" is Beijing.
.. Changed version number to use ONAP versions.
.. 10/08/2018 - Initial document for Casablanca release.
-.. Per Jorge, POLICY-785 did not get done in Casablanca (removed).
.. 05/29/2018 - Information for Beijing release.
.. 03/22/2018 - Initial document for Beijing release.
.. 01/15/2018 - Added change for version 1.1.3 to the Amsterdam branch. Also corrected prior version (1.2.0) to (1.1.1)