+
+.. ==========================
+.. * * * HONOLULU * * *
+.. ==========================
+
+Version: 8.0.1
+--------------
+
+:Release Date: 2021-08-12 (Honolulu Maintenance Release #1)
+
+**Artifacts**
+
+Artifacts released:
+
+.. csv-table::
+ :header: "Repository", "Java Artifact", "Docker Image (if applicable)"
+ :widths: 15,10,10
+
+ "policy/parent", "3.3.2", ""
+ "policy/common", "1.8.2", ""
+ "policy/models", "2.4.4", ""
+ "policy/api", "2.4.4", "onap/policy-api:2.4.4"
+ "policy/pap", "2.4.5", "onap/policy-pap:2.4.5"
+ "policy/drools-pdp", "1.8.4", "onap/policy-drools:1.8.4"
+ "policy/apex-pdp", "2.5.4", "onap/policy-apex-pdp:2.5.4"
+ "policy/xacml-pdp", "2.4.5", "onap/policy-xacml-pdp:2.4.5"
+ "policy/drools-applications", "1.8.4", "onap/policy-pdpd-cl:1.8.4"
+ "policy/distribution", "2.5.4", "onap/policy-distribution:2.5.4"
+ "policy/docker", "2.2.1", "onap/policy-jdk-alpine:2.2.1, onap/policy-jre-alpine:2.2.1"
+
+
+**Bug Fixes and Necessary Enhancements**
+
+
+ * `[POLICY-3062] <https://jira.onap.org/browse/POLICY-3062>`_ - Update the ENTRYPOINT in APEX-PDP Dockerfile
+ * `[POLICY-3066] <https://jira.onap.org/browse/POLICY-3066>`_ - Stackoverflow error in APEX standalone after changing to onap java image
+ * `[POLICY-3078] <https://jira.onap.org/browse/POLICY-3078>`_ - Support SSL communication in Kafka IO plugin of Apex-PDP
+ * `[POLICY-3173] <https://jira.onap.org/browse/POLICY-3173>`_ - APEX-PDP incorrectly reports successful policy deployment to PAP
+ * `[POLICY-3202] <https://jira.onap.org/browse/POLICY-3202>`_ - PDP-D: no locking feature: service loader not locking the no-lock-manager
+ * `[POLICY-3227] <https://jira.onap.org/browse/POLICY-3227>`_ - Implementation of context album improvements in apex-pdp
+ * `[POLICY-3230] <https://jira.onap.org/browse/POLICY-3230>`_ - Make default PDP-D and PDP-D-APPS work out of the box
+ * `[POLICY-3248] <https://jira.onap.org/browse/POLICY-3248>`_ - PdpHeartbeats are not getting processed by PAP
+ * `[POLICY-3301] <https://jira.onap.org/browse/POLICY-3301>`_ - Apex Avro Event Schemas - Not support for colon ':' character in field names
+ * `[POLICY-3305] <https://jira.onap.org/browse/POLICY-3305>`_ - Ensure XACML PDP application/translator methods are extendable
+ * `[POLICY-3331] <https://jira.onap.org/browse/POLICY-3331>`_ - PAP: should allow for external configuration of groups other than defaultGroup
+ * `[POLICY-3338] <https://jira.onap.org/browse/POLICY-3338>`_ - Upgrade CDS dependency to the latest version
+ * `[POLICY-3366] <https://jira.onap.org/browse/POLICY-3366>`_ - PDP-D: support configuration of overarching DMAAP https flag
+ * `[POLICY-3450] <https://jira.onap.org/browse/POLICY-3450>`_ - PAP should support turning on/off via configuration storing PDP statistics
+ * `[POLICY-3454] <https://jira.onap.org/browse/POLICY-3454>`_ - PDP-D CL APPS: swagger mismatched libraries cause telemetry shell to fail
+ * `[POLICY-3485] <https://jira.onap.org/browse/POLICY-3485>`_ - Limit statistics record count
+ * `[POLICY-3507] <https://jira.onap.org/browse/POLICY-3507>`_ - CDS Operation Policy execution runtime error
+ * `[POLICY-3516] <https://jira.onap.org/browse/POLICY-3516>`_ - Upgrade CDS dependency to the 1.1.5 version
+
+
+Known Limitations
+=================
+
+The APIs provided by xacml-pdp (e.g., healthcheck, statistics, decision)
+are always active. While PAP controls which policies are deployed to a
+xacml-pdp, it does not control whether or not the APIs are active.
+In other words, xacml-pdp will respond to decision requests, regardless
+of whether PAP has made it ACTIVE or PASSIVE.
+
+
+Version: 8.0.0
+--------------
+
+:Release Date: 2021-04-29 (Honolulu Release)
+
+New features
+============
+
+Artifacts released:
+
+.. csv-table::
+ :header: "Repository", "Java Artifact", "Docker Image (if applicable)"
+ :widths: 15,10,10
+
+ "policy/parent", "3.3.0", ""
+ "policy/common", "1.8.0", ""
+ "policy/models", "2.4.2", ""
+ "policy/api", "2.4.2", "onap/policy-api:2.4.2"
+ "policy/pap", "2.4.2", "onap/policy-pap:2.4.2"
+ "policy/drools-pdp", "1.8.2", "onap/policy-drools:1.8.2"
+ "policy/apex-pdp", "2.5.2", "onap/policy-apex-pdp:2.5.2"
+ "policy/xacml-pdp", "2.4.2", "onap/policy-xacml-pdp:2.4.2"
+ "policy/drools-applications", "1.8.2", "onap/policy-pdpd-cl:1.8.2"
+ "policy/distribution", "2.5.2", "onap/policy-distribution:2.5.2"
+ "policy/docker", "2.2.1", "onap/policy-jdk-alpine:2.2.1, onap/policy-jre-alpine:2.2.1"
+
+Key Updates
+===========
+
+* Enhanced statistics
+ - PDPs provide statistics, retrievable via PAP REST API
+* PDP deployment status
+ - Policy deployment API enhanced to reflect actual policy deployment status in PDPs
+ - Make PAP component stateless
+* Policy support
+ - Upgrade XACML 3.0 code to use new Time Extensions
+ - Enhancements for interoperability between Native Policies and other policy types
+ - Support for arbitrary policy types on the Drools PDP
+ - Improve handling of multiple policies in APEX PDP
+ - Update policy-models TOSCA handling with Control Loop Entities
+* Alternative locking mechanisms
+ - Support NO locking feature in Drools-PDP
+* Security
+ - Remove credentials in code from the Apex JMS plugin
+* Actor enhancements
+ - Actors should give better warnings than NPE when data is missing
+ - Remove old event-specific actor code
+* PDP functional assignments
+ - Make PDP type configurable in drools-pdp
+ - Make PDP type configurable in xacml-pdp
+* Performance improvements
+ - Support policy updates between PAP and the PDPs, phase 1
+* Maintainability
+ - Use ONAP base docker image
+ - Remove GPLv3 components from docker containers
+ - Move CSITs to Policy repos
+ - Deprecate server pool feature in drools-pdp
+* PoCs
+ - Merge CLAMP functionality into Policy Framework project
+ - TOSCA Defined Control Loop
+
+
+Known Limitations, Issues and Workarounds
+=========================================
+
+System Limitations
+~~~~~~~~~~~~~~~~~~
+
+The policy API component requires a fresh new database when migrating to the honolulu release.
+Therefore, upgrades require a fresh new database installation.
+Please see the
+`Installing or Upgrading Policy <https://docs.onap.org/projects/onap-policy-parent/en/honolulu/installation/oom.html#installing-or-upgrading-policy>`__ section for appropriate procedures.
+
+Known Vulnerabilities
+~~~~~~~~~~~~~~~~~~~~~
+
+Workarounds
+~~~~~~~~~~~
+
+* `POLICY-2998 <https://jira.onap.org/browse/POLICY-2998>`_ - Provide a script to periodically purge the statistics table
+
+Security Notes
+==============
+
+* `POLICY-3005 <https://jira.onap.org/browse/POLICY-3005>`_ - Bump direct dependency versions
+ - Upgrade org.onap.dmaap.messagerouter.dmaapclient to 1.1.12
+ - Upgrade org.eclipse.persistence to 2.7.8
+ - Upgrade org.glassfish.jersey.containers to 2.33
+ - Upgrade com.fasterxml.jackson.module to 2.11.3
+ - Upgrade com.google.re2j to 1.5
+ - Upgrade org.mariadb.jdbc to 2.7.1
+ - Upgrade commons-codec to 1.15
+ - Upgrade com.thoughtworks.xstream to 1.4.15
+ - Upgrade org.apache.httpcomponents:httpclient to 4.5.13
+ - Upgrade org.apache.httpcomponents:httpcore to 4.4.14
+ - Upgrade org.json to 20201115
+ - Upgrade org.projectlombok to 1.18.16
+ - Upgrade org.yaml to 1.27
+ - Upgrade io.cucumber to 6.9.1
+ - Upgrade org.apache.commons:commons-lang3 to 3.11
+ - Upgrade commons-io to 2.8.0
+* `POLICY-2943 <https://jira.onap.org/browse/POLICY-2943>`_ - Review license scan issues
+ - Upgrade com.hazelcast to 4.1.1
+ - Upgrade io.netty to 4.1.58.Final
+* `POLICY-2936 <https://jira.onap.org/browse/POLICY-2936>`_ - Upgrade to latest version of CDS API
+ - Upgrade io.grpc to 1.35.0
+ - Upgrade com.google.protobuf to 3.14.0
+
+
+References
+==========
+
+For more information on the ONAP Honolulu 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`_
+
+
+.. ========================
+.. * * * GUILIN * * *
+.. ========================
+
+Version: 7.0.0
+--------------
+
+:Release Date: 2020-12-03 (Guilin Release)
+
+New features
+============
+
+Artifacts released:
+
+.. csv-table::
+ :header: "Repository", "Java Artifact", "Docker Image (if applicable)"
+ :widths: 15,10,10
+
+ "policy/parent", "3.2.0", ""
+ "policy/common", "1.7.1", ""
+ "policy/models", "2.3.5", ""
+ "policy/api", "2.3.3", "onap/policy-api:2.3.3"
+ "policy/pap", "2.3.3", "onap/policy-pap:2.3.3"
+ "policy/drools-pdp", "1.7.4", "onap/policy-drools:1.7.4"
+ "policy/apex-pdp", "2.4.4", "onap/policy-apex-pdp:2.4.4"
+ "policy/xacml-pdp", "2.3.3", "onap/policy-xacml-pdp:2.3.3"
+ "policy/drools-applications", "1.7.5", "onap/policy-pdpd-cl:1.7.5"
+ "policy/distribution", "2.4.3", "onap/policy-distribution:2.4.3"
+ "policy/docker", "2.1.1", "onap/policy-jdk-alpine:2.1.1, onap/policy-jre-alpine:2.1.1"
+
+Key Updates
+===========
+
+* Kubernetes integration
+ - All components return with non-zero exit code in case of application failure
+ - All components log to standard out (i.e., k8s logs) by default
+ - Continue to write log files inside individual pods, as well
+* E2E Network Slicing
+ - Added ModifyNSSI operation to SO actor
+* Consolidated health check
+ - Indicate failure if there aren’t enough PDPs registered
+* Legacy operational policies
+ - Removed from all components
+* OOM helm charts refactoring
+ - Name standardization
+ - Automated certificate generation
+* Actor Model
+ - Support various use cases and provide more flexibility to Policy Designers
+ - Reintroduced the "usecases" controller into drools-pdp, supporting the use cases
+ under the revised actor architecture
+* Guard Application
+ - Support policy filtering
+* Matchable Application
+ - Support for ONAP or 3rd party components to create matchable policy types out of the box
+* Policy Lifecycle & Administration API
+ - Query/Delete by policy name & version without policy type
+* Apex-PDP enhancements
+ - Support multiple event & response types coming from a single endpoint
+ - Standalone installation now supports Tosca-based policies
+ - Legacy policy format has been removed
+ - Support chaining/handling of gRPC failure responses
+* Policy Distribution
+ - HPA decoders & related classes have been removed
+* Policy Engine
+ - Deprecated
+
+Known Limitations, Issues and Workarounds
+=========================================
+
+System Limitations
+~~~~~~~~~~~~~~~~~~
+
+The policy API component requires a fresh new database when migrating to the guilin release.
+Therefore, upgrades require a fresh new database installation.
+Please see the
+`Installing or Upgrading Policy <https://docs.onap.org/projects/onap-policy-parent/en/guilin/installation/oom.html#installing-or-upgrading-policy>`__ section for appropriate procedures.
+
+Known Vulnerabilities
+~~~~~~~~~~~~~~~~~~~~~
+
+* `POLICY-2463 <https://jira.onap.org/browse/POLICY-2463>`_ - In APEX Policy javascript task logic, JSON.stringify causing stackoverflow exceptions
+
+Workarounds
+~~~~~~~~~~~
+* `POLICY-2463 <https://jira.onap.org/browse/POLICY-2463>`_ - Use the stringify method of the execution context
+
+Security Notes
+==============
+
+* `POLICY-2878 <https://jira.onap.org/browse/POLICY-2878>`_ - Dependency upgrades
+ - Upgrade com.fasterxml.jackson to 2.11.1
+* `POLICY-2387 <https://jira.onap.org/browse/POLICY-2387>`_ - Dependency upgrades
+ - Upgrade org.json to 20200518
+ - Upgrade com.google.re2j to 1.4
+ - Upgrade com.thoughtworks.xstream to 1.4.12
+ - Upgrade org.eclipse.persistence to 2.2.1
+ - Upgrade org.apache.httpcomponents to 4.5.12
+ - Upgrade org.projectlombok to 1.18.12
+ - Upgrade org.slf4j to 1.7.30
+ - Upgrade org.codehaus.plexus to 3.3.0
+ - Upgrade com.h2database to 1.4.200
+ - Upgrade io.cucumber to 6.1.2
+ - Upgrade org.assertj to 3.16.1
+ - Upgrade com.openpojo to 0.8.13
+ - Upgrade org.mockito to 3.3.3
+ - Upgrade org.awaitility to 4.0.3
+ - Upgrade org.onap.aaf.authz to 2.1.21
+* `POLICY-2668 <https://jira.onap.org/browse/POLICY-2668>`_ - Dependency upgrades
+ - Upgrade org.java-websocket to 1.5.1
+* `POLICY-2623 <https://jira.onap.org/browse/POLICY-2623>`_ - Remove log4j dependency
+* `POLICY-1996 <https://jira.onap.org/browse/POLICY-1996>`_ - Dependency upgrades
+ - Upgrade org.onap.dmaap.messagerouter.dmaapclient to 1.1.11
+
+
+References
+==========
+
+For more information on the ONAP Guilin 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`_
+