Update Casablanca Maint release notes
[policy/engine.git] / docs / release-notes.rst
index 284145c..618ba29 100644 (file)
@@ -13,10 +13,144 @@ Policy Release Notes
 ..      * This note must be removed after content has been added.
 
 
-Version: 1.2.0
+..      ==========================
+..      * * *   CASABLANCA   * * *
+..      ==========================
+
+Version: 3.0.2
+--------------
+
+:Release Date: 2019-03-31 (Casablanca Maintenance Release #2)
+
+The following items were deployed with the Casablanca Maintenance Release:
+
+**Bug Fixes**
+
+    * [POLICY-1522] - Policy doesn't send "payload" field to APPC
+
+**Security Fixes**
+
+    * [POLICY-1538] - Upgrade Elasticsearch to 6.4.x to clear security issue
+    
+**License Issues**
+
+    * [POLICY-1433] - Remove proprietary licenses in PSSD test CSAR
+
+
+Version: 3.0.1
+--------------
+
+:Release Date: 2019-01-31 (Casablanca Maintenance Release)
+
+The following items were deployed with the Casablanca Maintenance Release:
+
+**New Features**
+
+    * [POLICY-1221] - Policy distribution application to support HTTPS communication
+    * [POLICY-1222] - Apex policy PDP to support HTTPS Communication
+
+**Bug Fixes** 
+
+    * `[POLICY-1282] <https://jira.onap.org/browse/POLICY-1282>`_ - Policy format with some problems
+    * `[POLICY-1395] <https://jira.onap.org/browse/POLICY-1395>`_ - Apex PDP does not preserve context on model upgrade
+
+
+Version: 3.0.0
+--------------
+
+:Release Date: 2018-11-30 (Casablanca Release)
+
+**New Features**
+
+The Casablanca release for POLICY delivered the following Epics. For a full list of stories and tasks delivered in the Casablanca release, refer to `JiraPolicyCasablanca`_ (Note: Jira details can also be viewed from this link).
+
+    * [POLICY-701] - This epic covers the work to integrate Policy into the SDC Service Distribution 
+    
+    The policy team introduced a new application into the framework that provides integration of the Service Distribution Notifications from SDC to Policy.
+        
+    * [POLICY-719] - This epic covers the work to build the Policy Lifecycle API
+    * [POLICY-726] - This epic covers the work to distribute policy from the PAP to the PDPs into the ONAP platform
+    * [POLICY-876] - This epics covers the work to re-build how the PAP organizes the PDP's into groups.
+    
+    The policy team did some forward looking spike work towards re-building the Software Architecture.
+
+    * [POLICY-809] - Maintain and implement performance
+    * [POLICY-814] - 72 hour stability testing (component and platform)
+    
+    The policy team made enhancements to the Drools PDP to further support S3P Performance.
+    For the new Policy SDC Distribution application and the newly ingested Apex PDP the team established S3P
+    performance standard and performed 72 hour stability tests.
+    
+    * [POLICY-824] - maintain and implement security
+    
+    The policy team established AAF Root Certificate for HTTPS communication and CADI/AAF integration into the
+    MVP applications. In addition, many java dependencies were upgraded to clear CLM security issues.
+    
+    * [POLICY-840] - Flexible control loop coordination facility. 
+
+    Work towards a POC for control loop coordination policies were implemented.
+
+    * [POLICY-841] - Covers the work required to support HPA
+
+    Enhancements were made to support the HPA use case through the use of the new Policy SDC Service Distribution application.
+
+    * [POLICY-842] - This epic covers the work to support the Auto Scale Out functional requirements
+    
+    Enhancements were made to support Scale Out Use Case to enforce new guard policies and updated SO and A&AI APIs.
+
+    * [POLICY-851] - This epic covers the work to bring in the Apex PDP code
+    
+    A new Apex PDP engine was ingested into the platform and work was done to ensure code cleared CLM security issues,
+    sonar issues, and checkstyle.
+    
+    * [POLICY-1081] - This epic covers the contribution for the 5G OOF PCI Optimization use case.
+
+    Policy templates changes were submitted that supported the 5G OOF PCI optimization use case.
+
+    * [POLICY-1182] - Covers the work to support CCVPN use case
+
+    Policy templates changes were submitted that supported the CCVPN use case.
+
+**Bug Fixes**
+
+The following bug fixes have been deployed with this release:
+
+    * `[POLICY-799] <https://jira.onap.org/browse/POLICY-799>`_ - Policy API Validation Does Not Validate Required Parent Attributes in the Model
+    * `[POLICY-869] <https://jira.onap.org/browse/POLICY-869>`_ - Control Loop Drools Rules should not have exceptions as well as die upon an exception
+    * `[POLICY-872] <https://jira.onap.org/browse/POLICY-872>`_ - investigate potential race conditions during rules version upgrades during call loads
+    * `[POLICY-878] <https://jira.onap.org/browse/POLICY-878>`_ - pdp-d: feature-pooling disables policy-controllers preventing processing of onset events
+    * `[POLICY-909] <https://jira.onap.org/browse/POLICY-909>`_ - get_ZoneDictionaryDataByName class type error
+    * `[POLICY-920] <https://jira.onap.org/browse/POLICY-920>`_ - Hard-coded path in junit test
+    * `[POLICY-921] <https://jira.onap.org/browse/POLICY-921>`_ - XACML Junit test cannot find property file
+    * `[POLICY-1083] <https://jira.onap.org/browse/POLICY-1083>`_ - Mismatch in action cases between Policy and APPC
+
+
+**Security Notes**
+
+POLICY 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 POLICY open Critical security vulnerabilities and their risk assessment have been documented as part of the `project (Casablanca Release) <https://wiki.onap.org/pages/viewpage.action?pageId=45300864>`_.
+
+Quick Links:
+    - `POLICY project page <https://wiki.onap.org/display/DW/Policy+Framework+Project>`_
+
+    - `Passing Badge information for POLICY <https://bestpractices.coreinfrastructure.org/en/projects/1614>`_
+
+    - `Project Vulnerability Review Table for POLICY (Casablanca Release) <https://wiki.onap.org/pages/viewpage.action?pageId=45300864>`_
+
+**Known Issues**
+    * `[POLICY-1277] <https://jira.onap.org/browse/POLICY-1277>`_ - policy config takes too long time to become retrievable in PDP
+    * `[POLICY-1282] <https://jira.onap.org/browse/POLICY-1282>`_ - Policy format with some problems
+
+
+
+..      =======================
+..      * * *   BEIJING   * * *
+..      =======================
+
+Version: 2.0.0
 --------------
 
-:Release Date: 2018-05-24 (Beijing Release)
+:Release Date: 2018-06-07 (Beijing Release)
 
 **New Features**
 
@@ -32,11 +166,9 @@ The Beijing release for POLICY delivered the following Epics. For a full list of
         - POLICY-568   Integration with org.onap AAF project
         - POLICY-610   Support vDNS scale out for multiple times in Beijing release
 
-
     * [POLICY-391] - This epic covers the work to support Release Planning activities
         - POLICY-552   ONAP Licensing Scan - Use Restrictions
 
-
     * [POLICY-392] - Platform Maturity Requirements - Performance Level 1
         - POLICY-529   Platform Maturity Performance - Drools PDP
         - POLICY-567   Platform Maturity Performance - PDP-X
@@ -84,45 +216,65 @@ The Beijing release for POLICY delivered the following Epics. For a full list of
 
 **Bug Fixes**
 
-    * POLICY-454       brmsgw 1.1.2 policy rules generation in a 1.1.1 docker image
-    * POLICY-484       Extend election handler run window and clean up error messages
-    * POLICY-494       POLICY EELF Audit.log not in ECOMP Standards Compliance
-    * POLICY-501       Fix issues blocking election handler and add directed interface for opstate
-    * POLICY-509       Add IntelliJ file to .gitingore
-    * POLICY-510       Do not enforce hostname validation
-    * POLICY-518       StateManagement creation of EntityManagers.
-    * POLICY-519       Correctly initialize the value of allSeemsWell in DroolsPdpsElectionHandler
-    * POLICY-629       Fixed a bug on editor screen
-    * POLICY-684       Fix regex for brmsgw dependency handling
-    * POLICY-707       ONAO-PAP-REST unit tests fail on first build on clean checkout 
-    * POLICY-717       Fix a bug in checking required fields if the object has include function
-    * POLICY-734       Fix Fortify Header Manipulation Issue
-    * POLICY-743       Fixed data name since its name was changed on server side
-    * POLICY-753       Policy Health Check failed with multi-node cluster
-    * POLICY-763       PDP-D throwing NullPointerException for multiple vDNS and VOLTE messages injected in parallel
-    * POLICY-765       junit test for guard fails intermittently
-    * POLICY-773       brmsgw failure pushing notification when executing update-vfw-op-policy.sh 
+The following bug fixes have been deployed with this release:
 
+    * `[POLICY-484] <https://jira.onap.org/browse/POLICY-484>`_ - Extend election handler run window and clean up error messages
+    * `[POLICY-494] <https://jira.onap.org/browse/POLICY-494>`_ - POLICY EELF Audit.log not in ECOMP Standards Compliance
+    * `[POLICY-501] <https://jira.onap.org/browse/POLICY-501>`_ - Fix issues blocking election handler and add directed interface for opstate
+    * `[POLICY-509] <https://jira.onap.org/browse/POLICY-509>`_ - Add IntelliJ file to .gitingore
+    * `[POLICY-510] <https://jira.onap.org/browse/POLICY-510>`_ - Do not enforce hostname validation
+    * `[POLICY-518] <https://jira.onap.org/browse/POLICY-518>`_ - StateManagement creation of EntityManagers.
+    * `[POLICY-519] <https://jira.onap.org/browse/POLICY-519>`_ - Correctly initialize the value of allSeemsWell in DroolsPdpsElectionHandler
+    * `[POLICY-629] <https://jira.onap.org/browse/POLICY-629>`_ - Fixed a bug on editor screen
+    * `[POLICY-684] <https://jira.onap.org/browse/POLICY-684>`_ - Fix regex for brmsgw dependency handling
+    * `[POLICY-707] <https://jira.onap.org/browse/POLICY-707>`_ - ONAO-PAP-REST unit tests fail on first build on clean checkout 
+    * `[POLICY-717] <https://jira.onap.org/browse/POLICY-717>`_ - Fix a bug in checking required fields if the object has include function
+    * `[POLICY-734] <https://jira.onap.org/browse/POLICY-734>`_ - Fix Fortify Header Manipulation Issue
+    * `[POLICY-743] <https://jira.onap.org/browse/POLICY-743>`_ - Fixed data name since its name was changed on server side
+    * `[POLICY-753] <https://jira.onap.org/browse/POLICY-753>`_ - Policy Health Check failed with multi-node cluster
+    * `[POLICY-765] <https://jira.onap.org/browse/POLICY-765>`_ - junit test for guard fails intermittently
 
 
-**Security Issues**
+**Security Notes**
+
+POLICY 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 POLICY open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=25437092>`_.
+
+Quick Links:
+       - `POLICY project page <https://wiki.onap.org/display/DW/Policy+Framework+Project>`_
+
+       - `Passing Badge information for POLICY <https://bestpractices.coreinfrastructure.org/en/projects/1614>`_
+
+       - `Project Vulnerability Review Table for POLICY <https://wiki.onap.org/pages/viewpage.action?pageId=25437092>`_
+
+**Known Issues**
+
+The following known issues will be addressed in a future release:
+
+    * `[POLICY-522] <https://jira.onap.org/browse/POLICY-522>`_ - PAP REST APIs undesired HTTP response body for 500 responses
+    * `[POLICY-608] <https://jira.onap.org/browse/POLICY-608>`_ - xacml components : remove hardcoded secret key from source code
+    * `[POLICY-764] <https://jira.onap.org/browse/POLICY-764>`_ - Policy Engine PIP Configuration JUnit Test fails intermittently
+    * `[POLICY-776] <https://jira.onap.org/browse/POLICY-776>`_ - OOF Policy TOSCA models are not correctly rendered
+    * `[POLICY-799] <https://jira.onap.org/browse/POLICY-799>`_ - Policy API Validation Does Not Validate Required Parent Attributes in the Model
+    * `[POLICY-801] <https://jira.onap.org/browse/POLICY-801>`_ - fields mismatch for OOF flavorFeatures between implementation and wiki
+    * `[POLICY-869] <https://jira.onap.org/browse/POLICY-869>`_  - Control Loop Drools Rules should not have exceptions as well as die upon an exception
+    * `[POLICY-872] <https://jira.onap.org/browse/POLICY-872>`_  - investigate potential race conditions during rules version upgrades during call loads
+
 
-   * Please see the `Policy R2 Beijing Security/Vulnerability Threat <https://wiki.onap.org/pages/viewpage.action?pageId=25437092>`_ page for security related issues.
 
 
-Version: 1.1.3
+Version: 1.0.2
 --------------
 
 :Release Date: 2018-01-18 (Amsterdam Maintenance Release)
 
 **Bug Fixes**
 
-The following bugs were deployed with the Amsterdam Maintenance Release:
+The following fixes were deployed with the Amsterdam Maintenance Release:
 
     * `[POLICY-486] <https://jira.onap.org/browse/POLICY-486>`_ - pdp-x api pushPolicy fails to push latest version
 
 
-Version: 1.1.1
+Version: 1.0.1
 --------------
 
 :Release Date: 2017-11-16 (Amsterdam Release)
@@ -204,20 +356,30 @@ The Amsterdam release continued evolving the design driven architecture of and f
 
 .. Links to jira release notes
 
+.. _JiraPolicyCasablanca: https://jira.onap.org/secure/ReleaseNote.jspa?projectId=10106&version=10446
 .. _JiraPolicyBeijing: https://jira.onap.org/secure/ReleaseNote.jspa?projectId=10106&version=10349
 .. _JiraPolicyAmsterdam: https://jira.onap.org/secure/ReleaseNote.jspa?projectId=10106&version=10300
 
 
 .. note
 ..      CHANGE  HISTORY
+..      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.
-..             For initial document: list epic and user stories for each, list user stories with no epics.  
-..             For Bugs section, list bugs that are not tied to an epic.  Remove all items with "Won't Do" resolution.
 ..      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)
-..      11/16/2017 - Initial document for Amsterdam release.
+..             Also, Set up initial information for Beijing.
+..             Excluded POLICY-454 from bug list since it doesn't apply to Beijing per Jorge.
  
 
 End of Release Notes
 
+.. How to notes for SS 
+..     For initial document: list epic and user stories for each, list user stories with no epics.  
+..             For Bugs section, list bugs that are not tied to an epic.  Remove all items with "Won't Do" resolution.
+..             For Known issues, list bugs that are slotted for a future release.