X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Frelease-notes.rst;h=9ca57d6e18803dcc1b6d84b6e1b1332b9788b512;hb=b0f136169fcf812b4f030a6d0ffe2817977b313c;hp=852498d255e54320d0eca0e50019bf3461b2eccb;hpb=bada304e4efb9939332711d4250cd6c673b37de7;p=policy%2Fparent.git diff --git a/docs/release-notes.rst b/docs/release-notes.rst index 852498d2..9ca57d6e 100644 --- a/docs/release-notes.rst +++ b/docs/release-notes.rst @@ -14,14 +14,1166 @@ Policy Release Notes .. * Except the date and the version number, all the other sections are optional but there must be at least .. * one section describing the purpose of this new release. +.. ========================== +.. * * * KOHN * * * +.. ========================== + +Version: 11.0.0 +--------------- + +:Release Date: 2022-11-20 (Kohn Release) + +Artifacts released: + +.. list-table:: + :widths: 15 10 10 + :header-rows: 1 + + * - Repository + - Java Artifact + - Docker Image (if applicable) + * - policy/parent + - 3.6.1 + - N/A + * - policy/docker + - 2.5.1 + - | policy-jre-alpine + | policy-jdk-alpine + | policy-db-migrator + * - policy/common + - 1.11.1 + - N/A + * - policy/models + - 2.7.1 + - N/A + * - policy/api + - 2.7.1 + - policy-api + * - policy/pap + - 2.7.1 + - policy-pap + * - policy/apex-pdp + - 2.8.1 + - policy-apex-pdp + * - policy/drools-pdp + - 1.11.1 + - policy-drools + * - policy/xacml-pdp + - 2.7.1 + - policy-xacml-pdp + * - policy/distribution + - 2.8.1 + - policy-distribution + * - policy/clamp + - 6.3.1 + - | policy-clamp-ac-pf-ppnt + | policy-clamp-ac-k8s-ppnt + | policy-clamp-ac-http-ppnt + | policy-clamp-runtime-acm' + * - policy/gui + - 2.3.1 + - policy-gui + * - policy/drools-applications + - 1.11.1 + - policy-pdpd-cl + +Key Updates +=========== + +* Support for O1 and A1 Policy Payloads in the 5G SON use Case + + The 5G SON policy is updated to allow O1 and A1 Policy payloads to be passed to SDN-R. Now, policies can pass O1 and + A1 Policy payloads. + + See: + - `REQ-1212 `_ - 5G SON use case enhancements for Kohn release + - `POLICY-4108 `_ Control Loop Policy for A1-based action for SON + Use Case + + +* Native Kafka messaging bewtween Policy Framework components + + The Policy Framework can now be configured to use Kafka for asynchronous communication between PAP and PDPs and + between CLAMP ACM Runtime and Participants. Kafka messaging is an alternative to using DMaaP MR for asynchronous + messaging. The Policy Framework components are configured to use either DMaaP or Kafka messaging, with DMaaP + being the default. This change is supported by APEX-PDP in this release and will be supported DROOLS-PDP and XACML-PDP + in future releases. + + See: + - `POLICY-4121 `_ - R11: DMaaP and Kafka updates + +* Support for Secured Database Communication + + Database communiction with MariaDB, MySql, or PostgreSQL can be configured to be secure. Secure database communication + is introduced for API, PAP, DROOLS-PDP and XACML-PDP. Support for secure database communication will be introduced in + CLAMP ACM in a future release. + + See: + - `POLICY-4176 `_ - Support Secured Database Connections + +* Support for MySql 8 + + The Policy Framework can use MySql 8 for persistence in addition to MariaDb and Postgres. Interoperability with MySql + 8 has been added for DB-MIGRATOR, API, PAP, DROOLS-PDP, XACML-PDP, and CLAM ACM. + + See: + - `POLICY-4314 `_ - Support for MySql 8.x DB client interfaces + +* Support for Service Mesh + + All Policy Framework components and images support service mesh and are service mesh compatible. The OOM charts for + all Policy Framework components have been updated to supprot configuration for Service Mesh. In addition, some minor + bugs in startup scripts were fixed to allow HTTP or HTTPS to be configured on components. + +* XACML-PDP improvements + + - Support for XACML 3.1 introduced + - Exposure of application level metrics + - Support for Postgres database as well as MariaDB + - Support for DCAE TCAGEN2 monitoring app changes + - Logging to standard output + - XACML tutorial updated and improved + + See: + - `POLICY-4049 `_ - R11: Improvements specific to xacml-pdp + +* DROOLS-PDP and DROOLS-Applications improvements + + - Latest Drools libraries supported + - JDBC pooling libraries upgraded + + See: + - `POLICY-4050 `_ - R11: Improvements specific to drools-pdp and drools-applications + +* APEX-PDP Improvements + + - Support for event definitions in JSON as well as AVRO is added + - Support for Metadata Set generation from the APEX CLI editor + - Support for deserialization of messages encoded in Avro carried over Kafka + + See: + - `POLICY-4048 `_ - R11: Improvements specific to apex-pdp + +* Policy-Distribution Improvements + + - Configuration added to allow distribution of CLAMP ACM compositions + - Policy distribution re-synchs if SDC is reinstalled + + See: + - `POLICY-4052 `_ - R11: Improvements to distribution + +* CLAMP Improvements + + - Instance properties can be edited + - Helm repository can be configured in the Kubernetes participant + + See: + - `POLICY-4053 `_ - R11: Improvements specific to clamp + +* System Attribute Improvements + - Demo Grafana dashboards available for policy framework components + - All parameters in Helm Charts have default values + - Springboot dependency handling improved in policy-parent + - CSITs amended to use HTTP rather than HTTPS and to use released image versions from Nexus when snapshot image + versions are not available + - Updates to database drivers to latest versions + +Known Limitations, Issues and Workarounds +========================================= + +System Limitations +~~~~~~~~~~~~~~~~~~ +N/A + +Known Vulnerabilities +~~~~~~~~~~~~~~~~~~~~~ +.. list-table:: + :widths: 8 3 5 15 + :header-rows: 1 + + * - Dependency + - Security Threat Level + - Policy Framework Components + - Comment + * - io.grpc:grpc-core:1.25.0 + - 6 + - | policy/models + | policy/apex-pdp + - Transitive dependency pulled in by the CDS project + * - io.springfox:springfox-swagger-ui:3.0.0 + - 6 + - | policy/api + | policy/pap + | policy/clamp + - Dependency used to generate Swagger files from annotations + * - io.springfox:springfox-swagger2:3.0.0 + - 6 + - | policy/api + | policy/pap + | policy/clamp + - Dependency used to generate Swagger files from annotations + * - io.projectreactor.netty:reactor-netty-core:1.0.19 + - 6 + - | policy/clamp + - TBC + * - io.projectreactor.netty:reactor-netty-http:1.0.19 + - 6 + - | policy/clamp + - TBC + * - org.webjars jquery-ui 1.12.1 + - 6 + - | policy/gui + - TBC + * - com.thoughtworks.xstream:xstream:1.4.17 + - 10 + - | policy/drools-pdp + - Pulled in by the Drools rule engine + * - org.apache.maven:maven-compat:3.3.9 + - 10 + - | policy/drools-pdp + - Pulled in by the Drools rule engine + * - org.apache.maven:maven-core:3.3.9 + - 10 + - | policy/drools-pdp + - Pulled in by the Drools rule engine + * - org.apache.maven:maven-settings:3.3.9 + - 10 + - | policy/drools-pdp + - Pulled in by the Drools rule engine + * - org.jsoup:jsoup:1.7.2 + - 10 + - | policy/drools-pdp + - Pulled in by the Drools rule engine + +Workarounds +~~~~~~~~~~~ +N/A + +Security Notes +============== +.. list-table:: + :widths: 8 3 5 15 + :header-rows: 1 + + * - Dependency + - Security Threat Level + - Policy Framework Components + - Comment + * - org.springframework:spring-web:5.3.22 + - 10 + - | policy/common + | policy/api + | policy/pap + | policy/clamp + | policy/gui + - Threat only applies when serialising and deserialising Java Objects, which the Policy Framework does not do + +Functional Improvements +======================= +| `POLICY-4108 `_ - Control Loop Policy for A1-based action for SON Use Case +| `POLICY-4356 `_ - 5g son policy models changes +| `POLICY-4357 `_ - 5g son policy drools apps changes + +| `POLICY-4121 `_ - R11: DMaaP and Kafka updates +| `POLICY-4131 `_ - Update the DMaaP client in the Policy Framework common utility library. +| `POLICY-4132 `_ - Check that all asynchronous messaging continues to work with updated DMaaP client +| `POLICY-4133 `_ - Add a Kafka client in the Policy Framework common utility library. +| `POLICY-4134 `_ - Configure the Policy Framework components to use Kafka along with DMaaP +| `POLICY-4135 `_ - Check that all asynchronous messaging continues to work with Kafka messaging +| `POLICY-4313 `_ - Move kafka version management to policy/parent/integration +| `POLICY-4204 `_ - OOM experimentation using strimzi +| `POLICY-4146 `_ - Add Prometheus counters for measuring SLAs on ACM REST endpoints +| `POLICY-4163 `_ - SLAs on REST Interfaces +| `POLICY-4166 `_ - Spike to understand metrics to measure SLAs +| `POLICY-4220 `_ - CSIT does not display logs for some containers +| `POLICY-4086 `_ - Improve CSIT to use proper currentInstanceCount value in PdpGroups +| `POLICY-4338 `_ - Convert CSITs to use HTTP rather than HTTPS +| `POLICY-4167 `_ - Add build instruction in readme + +| `POLICY-4120 `_ - R11: SUSE flavoured images in the Policy Framework +| `POLICY-4128 `_ - Create an OpenSuse docker file equivalent to the existing Alpine docker file for each image in the Policy Framework +| `POLICY-4129 `_ - Add a build profile to each repo build to trigger generation of Suse flavoured images +| `POLICY-4130 `_ - Add OCI Image spec labels to both Alpine and OpenSuse docker files +| `POLICY-4208 `_ - Reduce size of docker images +| `POLICY-4278 `_ - Upgrade OpenSuse to version 15.4 +| `POLICY-4334 `_ - Allow setting external dockerfile + +| `POLICY-3642 `_ - R11: Database and TOSCA related issues +| `POLICY-1749 `_ - Resolve specification of policy type versions in policies in TOSCA +| `POLICY-2540 `_ - Proper handling of data types in policy-models and policy-api +| `POLICY-3236 `_ - Adjust flexibility of Tosca Service Template Handling +| `POLICY-4067 `_ - Fetch all versions of a policyType API returning only the latest version +| `POLICY-4176 `_ - Support Secured Database Connections +| `POLICY-4314 `_ - Support for MySql 8.x DB client interfaces +| `POLICY-3489 `_ - Add script to load default data into tables using db-migrator +| `POLICY-3585 `_ - TOSCA Handling issues +| `POLICY-4097 `_ - Validate policy-api redundancy with at least 2 pods using J release +| `POLICY-4098 `_ - Validate policy-pap redundancy with at least 2 pods using J release +| `POLICY-4099 `_ - Spike to determine the work in apex-pdp for redundancy support +| `POLICY-4100 `_ - Spike to determine the work in drools-pdp for redundancy support + +| `POLICY-4048 `_ - R11: Improvements specific to apex-pdp +| `POLICY-4290 `_ - Support JSON based event schema in apex-pdp +| `POLICY-3446 `_ - Change apex-pdp to use BeanValidator +| `POLICY-3810 `_ - Fix sonar issues in apex-pdp +| `POLICY-4084 `_ - Apex cli editor should generate policies with metadataSet +| `POLICY-4285 `_ - Remove debian packaging from apex-pdp build +| `POLICY-4324 `_ - Fix Docker File for Apex MyFirstExample +| `POLICY-4369 `_ - Support KafkaAvroDeserializer in KafkaConsumer plugin of apex-pdp + +| `POLICY-4049 `_ - R11: Improvements specific to xacml-pdp +| `POLICY-3762 `_ - Expose application level metrics in xacml-pdp +| `POLICY-4187 `_ - Support postgresql in Xacml PDP +| `POLICY-4317 `_ - PAP, PDP-X: Support DCAE tcagen2 monitoring app changes +| `POLICY-3495 `_ - Xacml-pdp should log to stdout +| `POLICY-4171 `_ - Update Docker Tag related configurations in XACML Tutorial code +| `POLICY-4275 `_ - Upgrade XACML PDP to use XACML 3.1 release + +| `POLICY-4050 `_ - R11: Improvements specific to drools-pdp and drools-applications +| `POLICY-3960 `_ - Add/update documents for application metrics support in drools-pdp +| `POLICY-4177 `_ - Support secured DB communications for PDP-D Core +| `POLICY-4197 `_ - PDP-D: thread dump upon detection of application stuck session +| `POLICY-4213 `_ - PDP-D APPS: Jenkins jobs started to fail basic builds +| `POLICY-4281 `_ - Upgrade JDBC pooling libraries in drools +| `POLICY-4335 `_ - PDP-D: Upgrade to the latest version of drools libraries + +| `POLICY-4051 `_ - R11: Improvements to api, pap and policy handling +| `POLICY-3887 `_ - Enhancement in enhanced policy health check +| `POLICY-2874 `_ - Investigate Policy-API S3P stability test results +| `POLICY-4288 `_ - Check PAP CSIT Undeploy test timeout + +| `POLICY-4052 `_ - R11: Improvements to distribution +| `POLICY-4110 `_ - Update configuration changes for distribution of ACM +| `POLICY-2103 `_ - policy/distribution may need to re-synch if SDC gets reinstalled + +| `POLICY-4053 `_ - R11: Improvements specific to clamp +| `POLICY-4078 `_ - Investigation of DB issue within Policy Clamp runtime +| `POLICY-4341 `_ - ACM Runtime pod fails to come-up referencing to wrong filepath +| `POLICY-4365 `_ - Increase code coverage in clamp +| `POLICY-4094 `_ - Add Edit functionality for instance properties in Policy GUI +| `POLICY-4105 `_ - Remove usage of jackson libraries from clamp runtime acm +| `POLICY-4113 `_ - Make the permitted helm repository protocol a configurable parameter in k8s participant +| `POLICY-4224 `_ - Clean up CLAMP Docker handling +| `POLICY-4225 `_ - Fix type version in all tosca_service_template +| `POLICY-4229 `_ - Fix type version in all tosca_service_template in parent documetation +| `POLICY-4237 `_ - Add override parameters for enabling protocol in k8s-ppnt helm chart +| `POLICY-4240 `_ - Update PMSH service template for ACM +| `POLICY-4286 `_ - Junk output in the docker build for kubernetes participant +| `POLICY-4289 `_ - Refactoring redundant spring libraries defined in clamp pom files +| `POLICY-4371 `_ - Remove policy-clamp-be from OOM deployment for Service Mesh +| `POLICY-4382 `_ - Update ACM document in ONAP doc for Kohn release + +Necessary Improvements and Bug Fixes +==================================== + +Necessary Improvements +~~~~~~~~~~~~~~~~~~~~~~ +| `POLICY-4045 `_ - R11: Software (non functional) improvements +| `POLICY-3967 `_ - Create detailed grafana dashboards for each policy framework component +| `POLICY-4168 `_ - Security vulnerability when unzipping csar on distribution +| `POLICY-4169 `_ - Ensure all parameters in Helm Charts have default values +| `POLICY-3860 `_ - Analyze and improve spring boot dependencies management in PF components +| `POLICY-4207 `_ - Remove Jenkins jobs on Guilin branches +| `POLICY-4228 `_ - Add Ramesh Murugan Iyer as a committer +| `POLICY-4230 `_ - Update Weekly Meetings with status from daily scrums +| `POLICY-4234 `_ - Fix CSITs on Honolulu/Istanbul/Jakarta branches +| `POLICY-4242 `_ - PACKAGES UPGRADES IN DIRECT DEPENDENCIES FOR KOHN +| `POLICY-4280 `_ - Upgrade mariadb driver to latest 2.x version in PDP-D, and APPS +| `POLICY-4287 `_ - Update Docker Builds to allow for multiple architecture Docker Fille generation +| `POLICY-4308 `_ - Unmaintained Repos +| `POLICY-4354 `_ - Update INFO.yaml fine on all repos +| `POLICY-4393 `_ - Update dependencies to remove security vulnerabilities + +| `POLICY-4046 `_ - R11: Address technical debt left over from Previous Release +| `POLICY-4093 `_ - Update spring vesion in oparent and remove override in policy/parent + +Bug Fixes +~~~~~~~~~ +| `POLICY-4170 `_ - Fix k8s-ppnt cluster role binding name in OOM +| `POLICY-4186 `_ - Wrong versions of policy related jar in policy-xacml-pdp latest image +| `POLICY-4226 `_ - policy distribution cannot disable https to SDC +| `POLICY-4236 `_ - K8s participant marks the deployment failed if the deployment is initiated with a delay +| `POLICY-4238 `_ - CLAMP ACM docker image Java logging does not work +| `POLICY-4239 `_ - ACM commissioning fails with 404 error when deployed in CSIT docker +| `POLICY-4241 `_ - Participant update list in ACM is not populated with multiple AC elements +| `POLICY-4268 `_ - Logging directory mismatch for policy OOM components +| `POLICY-4269 `_ - Clamp Backend fails without AAF in Service Mesh +| `POLICY-4270 `_ - CSIT fails while executing CLAMP ACM test cases +| `POLICY-4274 `_ - XACML-PDP raw decision API serialization is incorrect +| `POLICY-4326 `_ - Look into Policy-Distribution grafana chart for negative heap memory +| `POLICY-4331 `_ - Policy-GUI Apex Broken Tests +| `POLICY-4339 `_ - Clamp build fails in policy participant module while processing policies without topology template +| `POLICY-4351 `_ - log of Element container is not visible at Standard Output +| `POLICY-4352 `_ - Lob type from jpa entities casting wrongly on postgres +| `POLICY-4353 `_ - JSON schema plugin is not working with multiple events mentioned in apex config with | separator +| `POLICY-4355 `_ - PodStatus Validator is failing to check if the pod is running in K8sParticipant + +References +========== + +For more information on the ONAP Kohn 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`_ + +.. ========================== +.. * * * JAKARTA * * * +.. ========================== + +Version: 10.0.0 +--------------- + +:Release Date: 2022-05-12 (Jakarta Release) + +Artifacts released: + +.. list-table:: + :widths: 15 10 10 + :header-rows: 1 + + * - Repository + - Java Artifact + - Docker Image (if applicable) + * - policy/parent + - 3.5.3 + - N/A + * - policy/docker + - 2.4.3 + - | policy-jre-alpine + | policy-jdk-alpine + | policy-db-migrator + * - policy/common + - 1.10.3 + - N/A + * - policy/models + - 2.6.3 + - N/A + * - policy/api + - 2.6.3 + - policy-api + * - policy/pap + - 2.6.3 + - policy-pap + * - policy/apex-pdp + - 2.7.3 + - policy-apex-pdp + * - policy/drools-pdp + - 1.10.3 + - policy-drools + * - policy/xacml-pdp + - 2.6.3 + - policy-xacml-pdp + * - policy/distribution + - 2.7.3 + - policy-distribution + * - policy/clamp + - 6.2.3 + - | policy-clamp-backend + | policy-clamp-ac-pf-ppnt + | policy-clamp-ac-k8s-ppnt + | policy-clamp-ac-http-ppnt + | policy-clamp-runtime-acm' + * - policy/gui + - 2.2.3 + - policy-gui + * - policy/drools-applications + - 1.10.3 + - policy-pdpd-cl + +Key Updates +=========== + +* `REQ-994 `_ - Control Loop in TOSCA LCM Improvement + CLAMP (Control Loop Automation Management Platform) functionalities, moved to the Policy project in the Istanbul + release, provides a Control Loop Lifecycle management architecture. A control Loop is a key concept for Automation + and Assurance Use Cases and remains a top priority for ONAP as an automation platform butit is not the only possible + composition of components that is possible to combine to deliver functionality. + + This work evolves the Control Loop LCM architecture to provide abstract Automation Composition + Management (ACM) logic with a generic Automation Composition definition, isolating Composition logic logic from ONAP + component logic. It elaborates APIs that allow integrate with other design systems as well as 3PP component integration. + + The current PMSH and TCS control loops are migrated to use an Automation Composition approach. Support for Automation + Compositions in SDC is also introduced. + +* Metadata Sets for Policy Types. + + A Metadata set allows a global set of metadata containing rules or global parameters that all instances of a certain + policy type can use. Metadta sets are introduced in the Policy Framework in the Jakarta release. This means that + different rule set implementations can be associated with a policy type, which can be used in appropriate situations. + +* Introduction of Prometheus for monitoring Policy components so that necessary alerts can be easily triggered and + possible outages can be avoided in production systems. + + * Expose application level metrics in policy components. An end user can plug in a prometheus instance and start + listening to the metrics exposed by policy components and either raise alerts or show them on a Grafana dashboard + for operations team to keep monitoring the health of the system. + + * Provide sample Grafana dashboards for policy metrics. + +* Improve the policy/api and policy/pap readiness probes to handle database failures so that the policy/api and + policy/pap kubernetes pods are marked ready only if the policy database pod is ready. + +* Migration of Policy Framework components to Springboot to support easier handling, configuration and maintenance. + The migrated components are policy/api, policy/pap, policy/clamp, and policy/gui. + +* Enhanced healthchecks on drools pdp to report on stuck applications. This together with enhanced liveness probes + self-heals the unresponsive pod in such condition by restarting it. + +* Drools PDP has been upgraded to the latest available stable version: 7.68.0.Final. + +* Extend CDS actor model to decouple VNF handling from the vFirewall use case. + +* Policy Framework Database Configurability. Some of the components in the Policy Framework can be configured to use + any JDBC-compliant RDBMS and configuraiton files are supplied for the Postgres RDBMS. MariaDB remains the default + RDBMS for the Policy Framework in ONAP. Further testing will be carried out using Postgres in Kohn and future + releases. + +* System Attribute Improvements + - Transaction boundaries on REST calls are implemented per REST call on applications migrated to Spring (policy/api, + policy/pap, and policy/clamp) + - JDBC backend uses Spring and Hibernate rather than Eclipselink + - All GUIs are now included in the policy/gui microservice + - Documentation is retionalized and cleaned up, testing documentation is now complete + - Scripts are added to make release of the Policy Framework easier + +Known Limitations, Issues and Workarounds +========================================= + +System Limitations +~~~~~~~~~~~~~~~~~~ +N/A + +Known Vulnerabilities +~~~~~~~~~~~~~~~~~~~~~ +N/A + +Workarounds +~~~~~~~~~~~ +N/A + +Security Notes +============== + +| `POLICY-2744 `_ - Use an account other than healthcheck in API and PAP components for provisioning of policies +| `POLICY-3815 `_ - Use an account other than healthcheck in API and PAP components for provisioning of policies - OOM Charts +| `POLICY-3862 `_ - Check all code for Log4J before version 2.15.0 and upgrade if necessary +| `POLICY-4085 `_ - Remove usage of jackson libraries from clamp runtime + + +Functional Improvements +======================= +| `POLICY-1837 `_ - Review transaction boundaries of models +| `POLICY-2715 `_ - Allow underlying database to be configured: MariaDB or Postgres +| `POLICY-2952 `_ - R10: TOSCA Control Loop Design Time +| `POLICY-2973 `_ - Build interaction between SDC and Design Time Catalogue +| `POLICY-3034 `_ - Support statistics in PDP-X +| `POLICY-3213 `_ - Persistence Policy Models using JPA/JDBC/Hibernate/MariaDB +| `POLICY-3498 `_ - Provide API to retrieve policies deployed since a given time +| `POLICY-3579 `_ - End to End Demo of PMSH usecase +| `POLICY-3582 `_ - Uber Story: Cover the full scope of LCM for Control Loops: Server Side +| `POLICY-3638 `_ - Change policy-gui so that all GUIs work in the same jar/JVM +| `POLICY-3745 `_ - PDP-D: Upgrade drools to the latest 7.x release +| `POLICY-3747 `_ - Support Readiness and Liveness probes on Control loop helm charts +| `POLICY-3748 `_ - Enable cluster admin role for k8s participant helm chart in OOM +| `POLICY-3750 `_ - R10: Improve runtime monitoring capabilities in policy components +| `POLICY-3753 `_ - Migrate policy-api component to spring boot +| `POLICY-3754 `_ - Migrate policy-pap component to spring boot +| `POLICY-3755 `_ - Create a list of application metrics to be exposed in policy framework components +| `POLICY-3756 `_ - Expose application level metrics in policy-api +| `POLICY-3757 `_ - Expose application level metrics in policy-pap +| `POLICY-3759 `_ - Expose application level metrics in policy-distribution +| `POLICY-3760 `_ - Expose application level metrics in apex-pdp +| `POLICY-3761 `_ - Expose application level metrics in drools-pdp +| `POLICY-3763 `_ - Improve policy-api & policy-pap readiness probes to handle db failures +| `POLICY-3777 `_ - R10: Control Loop in TOSCA LCM improvement +| `POLICY-3781 `_ - R10: Policy Framework Database Configurability +| `POLICY-3808 `_ - Commission a Control Loop Type from a Control Loop Type package/service +| `POLICY-3816 `_ - Support Policy Type Metadata Sets in Policy Framework +| `POLICY-3823 `_ - Proof of concept of Controlloop design time with SDC +| `POLICY-3835 `_ - Write scripts to make release of the Policy Framework easier +| `POLICY-3839 `_ - Migrate controlloop runtime from Eclipselink to Hibernate +| `POLICY-3865 `_ - PDP-D APPS: extend CDS actor VNF operations support +| `POLICY-3870 `_ - Add Controlloop design-time components to SDC +| `POLICY-3886 `_ - Create basic installation & setup for prometheus & grafana +| `POLICY-3889 `_ - Implement TCS Control Loops using a TOSCA appraoch +| `POLICY-3892 `_ - Create basic grafana dashboards for monitoring policy framework components +| `POLICY-3896 `_ - Change Apex Editor to use Spring Boot +| `POLICY-3902 `_ - Extend PDP-X statistics endpoint to support per application metrics +| `POLICY-3921 `_ - Align TOSCA Control Loop with Automation Composition +| `POLICY-3938 `_ - Rename CLAMP "TOSCA Control Loop" feature to CLAMP "Automation Composition Management" +| `POLICY-4040 `_ - Enable prometheus monitoring on drools-pdp charts + +Necessary Improvements and Bug Fixes +==================================== + +Necessary Improvements +~~~~~~~~~~~~~~~~~~~~~~ +| `POLICY-1820 `_ - Transfer APEX model to use policy-models +| `POLICY-2086 `_ - Remove references to mariadb from resource files +| `POLICY-2587 `_ - CLC target locking behavior needs to be by-passed for CLC to be effective +| `POLICY-2588 `_ - Target Locking Implementations should be configurable +| `POLICY-2683 `_ - REQ-443 improve its CII Badging score by improving input validation and documenting it in their CII Badging site. +| `POLICY-3076 `_ - Improve code coverage in policy framework repos +| `POLICY-3259 `_ - Components should not crash at start-up due to dmaap issues +| `POLICY-3269 `_ - Allow policy to disable guard check in drools-apps +| `POLICY-3358 `_ - Remove Clamp GUI from Clamp Repo +| `POLICY-3380 `_ - Archive onap/clamp and remove any jenkins jobs +| `POLICY-3386 `_ - PDP-D: better liveness checks to recover from stuck sessions +| `POLICY-3540 `_ - Refactor Participant Interfaces and Tests +| `POLICY-3708 `_ - Improve Documentation for Jakarta Release +| `POLICY-3710 `_ - Tidy up the Policy Framework documentation +| `POLICY-3791 `_ - sphinx-build warnings in policy parent docs +| `POLICY-3804 `_ - Add gui-clamp coverage info to sonar +| `POLICY-3866 `_ - Tidy up Policy Framework Documentation +| `POLICY-3885 `_ - Document metadataSet usage in policy documentation +| `POLICY-3895 `_ - Improve drools pdp and drools apps logging +| `POLICY-3920 `_ - Write a User Guide for TOSCA Control Loops in CLAMP +| `POLICY-3927 `_ - Remove Unused maven dependencies in apex-editor +| `POLICY-3928 `_ - Remove Unused test resources in apex-editor +| `POLICY-3977 `_ - PDP-D: enhanced healthchecks for monitoring subcomponents +| `POLICY-3979 `_ - PDP-D + APPS: investigate configuration to use MySql instead of MariaDB + +Bug Fixes +~~~~~~~~~ +| `POLICY-3153 `_ - Fix Db connection issues in TOSCA control loop +| `POLICY-3589 `_ - Http participant unable to resolve Intermediary config during startup +| `POLICY-3743 `_ - APEX-PDP RestClient reports failure when response code!=200 +| `POLICY-3749 `_ - Drools CSITs failing due to version related problem +| `POLICY-3780 `_ - Update endpoints in xacml-pdp jmx files +| `POLICY-3794 `_ - Cannot create a new APEX policy on Policy Editor +| `POLICY-3831 `_ - Camel Integration Tests Failing +| `POLICY-3871 `_ - Fix issues in existing entity classes in policy-models +| `POLICY-3893 `_ - apex-pdp intermittent error in build +| `POLICY-3897 `_ - Fix issue with usage of GeneratedValue in PfGeneratedIdKey +| `POLICY-3905 `_ - drools pdp merge job failing +| `POLICY-3913 `_ - Fix issue where some metrics are lost in spring boot +| `POLICY-3914 `_ - Fix spring configuration for pap csit +| `POLICY-3929 `_ - Race condition in apex-editor model upload +| `POLICY-3933 `_ - CLAMP CSIT failing with HTTP 401 unauthorized for URL error +| `POLICY-3978 `_ - Changing default append on instance name +| `POLICY-3983 `_ - Policy-API is not using the mounted logback.xml file +| `POLICY-4030 `_ - PAP/API healthcheck response code not in line with the actual health report +| `POLICY-4039 `_ - Fix configuration issues causing automation composition issues +| `POLICY-4041 `_ - Duplicate log entries in policy-gui +| `POLICY-4043 `_ - Batch deploy/undeploy operations incrementing corresponding apex counter by only 1 +| `POLICY-4044 `_ - APEX-PDP engine metrics remain 0 even after execution of events +| `POLICY-4068 `_ - PAP consolidated healthcheck returning report with empty url for PAP +| `POLICY-4087 `_ - Inconsistent behaviour in APEX when PDP STATE changed to PASSIVE and then ACTIVE +| `POLICY-4088 `_ - PAP shows incorrect deployments counter on parallel deploy/undeploy +| `POLICY-4092 `_ - Modify Nssi Closed Loop Error +| `POLICY-4095 `_ - Failures on Daily Master tests onap-policy-clamp-runtime-acm +| `POLICY-4096 `_ - Policy deployment fails if prometheus operator is not installed +| `POLICY-4104 `_ - Issue when serialization into JSON Object which brings allot of garbage +| `POLICY-4106 `_ - PDP-D APPS: Network Slicing: incorrect SO operation + +References +========== + +For more information on the ONAP Jakarta 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`_ + +.. ========================== +.. * * * ISTANBUL * * * +.. ========================== + +Version: 9.0.1 +-------------- + +:Release Date: 2022-02-17 (Istanbul Maintenance Release #1) + +**Artifacts** + +Artifacts released: + +.. list-table:: + :widths: 15 10 10 + :header-rows: 1 + + * - Repository + - Java Artifact + - Docker Image (if applicable) + * - policy/parent + - 3.4.4 + - N/A + * - policy/docker + - 2.3.2 + - | onap/policy-jdk-alpine:2.3.2 + | onap/policy-jre-alpine:2.3.2 + | onap/policy-db-migrator:2.3.2 + * - policy/common + - 1.9.2 + - N/A + * - policy/models + - 2.5.2 + - N/A + * - policy/api + - 2.5.2 + - onap/policy-api:2.5.2 + * - policy/pap + - 2.5.2 + - onap/policy-pap:2.5.2 + * - policy/drools-pdp + - 1.9.2 + - onap/policy-drools:1.9.2 + * - policy/apex-pdp + - 2.6.2 + - onap/policy-apex-pdp:2.6.2 + * - policy/xacml-pdp + - 2.5.2 + - onap/policy-xacml-pdp:2.5.2 + * - policy/drools-applications + - 1.9.2 + - onap/policy-pdpd-cl:1.9.2 + * - policy/clamp + - 6.1.4 + - | onap/policy-clamp-backend:6.1.4 + | onap/policy-clamp-frontend:6.1.4 + | onap/policy-clamp-cl-pf-ppnt:6.1.4 + | onap/policy-clamp-cl-k8s-ppnt:6.1.4 + | onap/policy-clamp-cl-http-ppnt:6.1.4 + | onap/policy-clamp-cl-runtime:6.1.4 + * - policy/gui + - 2.1.2 + - onap/policy-gui:2.1.2 + * - policy/distribution + - 2.6.2 + - onap/policy-distribution:2.6.2 + +**Bug Fixes and Necessary Enhancements** + + * `[POLICY-3862] `_ + - Check all code for Log4J before version 2.15.0 and upgrade if necessary + +Version: 9.0.0 +-------------- + +:Release Date: 2021-11-04 (Istanbul Release) + +New features +============ + +Artifacts released: + +.. list-table:: + :widths: 15 10 10 + :header-rows: 1 + + * - Repository + - Java Artifact + - Docker Image (if applicable) + * - policy/parent + - 3.4.3 + - N/A + * - policy/docker + - 2.3.1 + - | onap/policy-jdk-alpine:2.3.1 + | onap/policy-jre-alpine:2.3.1 + | onap/policy-db-migrator:2.3.1 + * - policy/common + - 1.9.1 + - N/A + * - policy/models + - 2.5.1 + - N/A + * - policy/api + - 2.5.1 + - onap/policy-api:2.5.1 + * - policy/pap + - 2.5.1 + - onap/policy-pap:2.5.1 + * - policy/drools-pdp + - 1.9.1 + - onap/policy-drools:1.9.1 + * - policy/apex-pdp + - 2.6.1 + - onap/policy-apex-pdp:2.6.1 + * - policy/xacml-pdp + - 2.5.1 + - onap/policy-xacml-pdp:2.5.1 + * - policy/drools-applications + - 1.9.1 + - onap/policy-pdpd-cl:1.9.1 + * - policy/clamp + - 6.1.3 + - | onap/policy-clamp-backend:6.1.3 + | onap/policy-clamp-frontend:6.1.3 + | onap/policy-clamp-cl-pf-ppnt:6.1.3 + | onap/policy-clamp-cl-k8s-ppnt:6.1.3 + | onap/policy-clamp-cl-http-ppnt:6.1.3 + | onap/policy-clamp-cl-runtime:6.1.3 + * - policy/gui + - 2.1.1 + - onap/policy-gui:2.1.1 + * - policy/distribution + - 2.6.1 + - onap/policy-distribution:2.6.1 + +Key Updates +=========== + +Clamp -> policy +Control Loop +Database + +* `REQ-684 `_ - Merge CLAMP functionality into Policy Framework project + - keep CLAMP functions into ONAP + - reduce ONAP footprint + - consolidate the UI (Control loop UI and policy) + - enables code sharing and common handling for REST and TOSCA + - introduces the Spring Framework into the Policy Framework + - see `the CLAMP documentation `_ + +* `REQ-716 `_ - Control Loop in TOSCA LCM + - Allows Control Loops to be defined and described in Metadata using TOSCA + - Control loops can run on the fly on any component that implements a *participant* API + - Control Loops can be commissioned into Policy/CLAMP, they can be parameterized, initiated on arbitrary + participants, activated and monitored + - See `the CLAMP TOSCA Control Loop documentation + `_ + +* CLAMP Client Policy and TOSCA Handling + - Push existing policy(tree) into pdp + - Handling of PDP Groups + - Handling of Policy Types + - Handling of TOSCA Service Templates + - Push of Policies to PDPs + - Support multiple PDP Groups per Policy Type + - Tree view in Policies list + - Integration of new TOSCA Control Loop GUI into CLAMP GUI + +* Policy Handling Improvements + - Support delta policies in PDPs + - Allow XACML rules to specify EventManagerService + - Sending of notifications to Kafka & Rest in apex-pdp policies + - External configuration of groups other than defaultGroup + - XACML Decision support for Multiple Requests + - Updated query parameter names and support for wildcards in APIs + - Added new APIs for Policy Audit capabilities + - Capability to send multiple output events from a state in APEX-PDP + +* System Attribute Improvements + - Support for upgrade and rollback, starting with upgrade from the Honolulu release to the Istanbul release + - Consolidated health check + - Phase 1 of Spring Framework introduction + - Phase 1 of Prometheus introduction, base Prometheus metrics + +Known Limitations, Issues and Workarounds +========================================= + +System Limitations +~~~~~~~~~~~~~~~~~~ +N/A + +Known Vulnerabilities +~~~~~~~~~~~~~~~~~~~~~ +N/A + +Workarounds +~~~~~~~~~~~ +N/A + +Security Notes +============== + +| `POLICY-3169 `_ - Remove security issues reported by NEXUS-IQ +| `POLICY-3315 `_ - Review license scan issues +| `POLICY-3327 `_ - OOM AAF generated certificates contain invalid SANs entries +| `POLICY-3338 `_ - Upgrade CDS dependency to the latest version +| `POLICY-3384 `_ - Use signed certificates in the CSITs +| `POLICY-3431 `_ - Review license scan issues +| `POLICY-3516 `_ - Upgrade CDS dependency to the 1.1.5 version +| `POLICY-3590 `_ - Address security vulnerabilities and License issues in Policy Framework +| `POLICY-3697 `_ - Review license scan issues + + +Functional Improvements +======================= +| `REQ-684 `_ - Merge CLAMP functionality into Policy Framework project +| `REQ-716 `_ - Control Loop in TOSCA LCM +| `POLICY-1787 `_ - Support mariadb upgrade/rollback functionality +| `POLICY-2535 `_ - Query deployed policies by regex on the name, for a given policy type +| `POLICY-2618 `_ - PDP-D make legacy configuration interface (used by brmsgw) an optional feature +| `POLICY-2769 `_ - Support multiple PAP instances +| `POLICY-2865 `_ - Add support and documentation on how an application can control what info is returned in Decision API +| `POLICY-2896 `_ - Improve consolidated health check to include dependencies +| `POLICY-2920 `_ - policy-clamp ui is capable to push and existing policy(tree) into pdp +| `POLICY-2921 `_ - use the policy-clamp ui to manage pdp groups +| `POLICY-2923 `_ - use the policy-clamp ui to manage policy types +| `POLICY-2930 `_ - clamp-backend rest api to push policies to pdp +| `POLICY-2931 `_ - clamp GUI to push policy to pdp +| `POLICY-3072 `_ - clamp ui support multiple pdp group per policy type +| `POLICY-3107 `_ - Support delta policies in PDPs +| `POLICY-3165 `_ - Implement tree view in policies list +| `POLICY-3209 `_ - CLAMP Component Lifecycle Management using Spring Framework +| `POLICY-3218 `_ - Integrate CLAMP GUIs (Instantiation/Monitoring) in the policy-gui repo +| `POLICY-3227 `_ - Implementation of context album improvements in apex-pdp +| `POLICY-3228 `_ - Implement clamp backend part to add policy models api +| `POLICY-3229 `_ - Implement the front end part to add tosca model +| `POLICY-3230 `_ - Make default PDP-D and PDP-D-APPS work out of the box +| `POLICY-3260 `_ - Allow rules to specify EventManagerService +| `POLICY-3324 `_ - Design a solution for sending notifications to Kafka & Rest in apex-pdp policies +| `POLICY-3331 `_ - PAP: should allow for external configuration of groups other than defaultGroup +| `POLICY-3340 `_ - Create REST API's in PAP to fetch the audit information stored in DB +| `POLICY-3514 `_ - XACML Decision support for Multiple Requests +| `POLICY-3524 `_ - Explore options to integrate prometheus with policy framework components +| `POLICY-3527 `_ - Update query parameter names in policy audit api's +| `POLICY-3533 `_ - PDP-D: make DB port provisionable +| `POLICY-3538 `_ - Export basic metrics from policy components for prometheus +| `POLICY-3545 `_ - Use generic create policy url in policy/distribution +| `POLICY-3557 `_ - Export basic prometheus metrics from clamp + +Necessary Improvements and Bug Fixes +==================================== + +Necessary Improvements +~~~~~~~~~~~~~~~~~~~~~~ +| `POLICY-2418 `_ - Refactor XACML PDP POJO's into Bean objects in order to perform validation more simply +| `POLICY-2429 `_ - Mark policy/engine read-only and remove ci-management jobs for it +| `POLICY-2542 `_ - Improve the REST parameter validation for PAP api's +| `POLICY-2767 `_ - Improve error handling of drools-pdp when requestID in onset is not valid UUID +| `POLICY-2899 `_ - Store basic audit details of deploy/undeploy operations in PAP +| `POLICY-2996 `_ - Address technical debt left over from Honolulu +| `POLICY-3059 `_ - Fix name of target-database property in persistence.xml files +| `POLICY-3062 `_ - Update the ENTRYPOINT in APEX-PDP Dockerfile +| `POLICY-3078 `_ - Support SSL communication in Kafka IO plugin of Apex-PDP +| `POLICY-3087 `_ - Use sl4fj instead of EELFLogger +| `POLICY-3089 `_ - Cleanup logs for success/failure consumers in apex-pdp +| `POLICY-3096 `_ - Fix intermittent test failures in APEX +| `POLICY-3128 `_ - Use command command-line handler across policy repos +| `POLICY-3129 `_ - Refactor command-line handling across policy-repos +| `POLICY-3132 `_ - Apex-pdp documentation refers to missing logos.png +| `POLICY-3134 `_ - Use base image for policy-jdk docker images +| `POLICY-3136 `_ - Ignore jacoco and checkstyle when in eclipse +| `POLICY-3143 `_ - Remove keystore files from policy repos +| `POLICY-3145 `_ - HTTPS clients should not allow self-signed certificates +| `POLICY-3147 `_ - Xacml-pdp should not use RestServerParameters for client parameters +| `POLICY-3155 `_ - Use python3 for CSITs +| `POLICY-3160 `_ - Use "sh" instead of "ash" where possible +| `POLICY-3163 `_ - Remove spaces from xacml file name +| `POLICY-3166 `_ - Use newer onap base image in clamp +| `POLICY-3171 `_ - Fix sporadic error in models provider junits +| `POLICY-3175 `_ - Minor clean-up of drools-apps +| `POLICY-3182 `_ - Update npm repo +| `POLICY-3189 `_ - Create a new key class which uses the @GeneratedValue annotation +| `POLICY-3190 `_ - Investigate handling of context albums in Apex-PDP for failure responses (ex - AAI) +| `POLICY-3198 `_ - Remove VirtualControlLoopEvent from OperationsHistory classes +| `POLICY-3211 `_ - Parameter Handling and Parameter Validation +| `POLICY-3214 `_ - Change Monitoring UI implementation to use React +| `POLICY-3215 `_ - Update CLAMP Module structure to Multi Module Maven approach +| `POLICY-3221 `_ - wrong lifecycle state information in INFO.yaml for policy/clamp +| `POLICY-3222 `_ - Use existing clamp gui to set the parameters during CL instantiation +| `POLICY-3235 `_ - gui-editor-apex fails to start +| `POLICY-3257 `_ - Update csit test cases to include policy status & statistics api's +| `POLICY-3261 `_ - Rules need a way to release locks +| `POLICY-3262 `_ - Extract more common code from UsecasesEventManager +| `POLICY-3292 `_ - Update the XACML PDP Tutorial docker compose files to point to release Honolulu images +| `POLICY-3298 `_ - Add key names to IndexedXxx factory class toString() methods +| `POLICY-3299 `_ - Merge policy CSITs into docker/csit +| `POLICY-3300 `_ - PACKAGES UPGRADES IN DIRECT DEPENDENCIES FOR ISTANBUL +| `POLICY-3303 `_ - Update the default logback.xml in APEX to log to STDOUT +| `POLICY-3305 `_ - Ensure XACML PDP application/translator methods are extendable +| `POLICY-3306 `_ - Fix issue where apex-pdp test is failing in gitlab +| `POLICY-3307 `_ - Turn off frankfurt CSITs +| `POLICY-3333 `_ - bean validator should use SerializedName +| `POLICY-3336 `_ - APEX CLI/Model: multiple outputs for nextState NULL +| `POLICY-3337 `_ - Move clamp documentation to policy/parent +| `POLICY-3366 `_ - PDP-D: support configuration of overarching DMAAP https flag +| `POLICY-3367 `_ - oom: policy-clamp-create-tables.sql: add IF NOT EXISTS clauses +| `POLICY-3374 `_ - Docker registry should be defined in the parent pom +| `POLICY-3378 `_ - Move groovy scripts to separate/common file +| `POLICY-3382 `_ - Create document for policy chaining in drools-pdp +| `POLICY-3383 `_ - Standardize policy deployment vs undeployment count in PdpStatistics +| `POLICY-3388 `_ - policy/gui merge jobs failing +| `POLICY-3389 `_ - Use lombok annotations instead of hashCode, equals, toString, get, set +| `POLICY-3404 `_ - Rolling DB errors in log output for API, PAP, and DB components +| `POLICY-3419 `_ - Remove operationshistory10 DB +| `POLICY-3450 `_ - PAP should support turning on/off via configuration storing PDP statistics +| `POLICY-3456 `_ - Use new RestClientParameters class instead of BusTopicParams +| `POLICY-3457 `_ - Topic source should not go into fast-fail loop when dmaap is unreachable +| `POLICY-3459 `_ - Document how to turn off collection of PdpStatistics +| `POLICY-3473 `_ - CSIT for xacml doesn't check dmaap msg status +| `POLICY-3474 `_ - Delete extra simulators from policy-models +| `POLICY-3486 `_ - policy-jdk docker image should have at least one up to date image +| `POLICY-3499 `_ - Improve Apex-PDP logs to avoid printing errors for irrelevant events in multiple policy deployment +| `POLICY-3501 `_ - Refactor guard actor +| `POLICY-3511 `_ - Limit statistics record count +| `POLICY-3525 `_ - Improve policy/pap csit automation test cases +| `POLICY-3528 `_ - Update documents & postman collection for pdp statistics api's +| `POLICY-3531 `_ - PDP-X: initialization delays causes liveness checks to be missed under OOM deployment +| `POLICY-3532 `_ - Add Honolulu Maintenance Release notes to read-the-docs +| `POLICY-3539 `_ - Use RestServer from policy/common in apex-pdp +| `POLICY-3547 `_ - METADATA tables for policy/docker db-migrator should be different than counterpart in policy/drools-pdp seed +| `POLICY-3556 `_ - Document xacml REST server limitations +| `POLICY-3605 `_ - Enhance dmaap simulator to support ""/topics" endpoint +| `POLICY-3609 `_ - Add CSIT test case for policy consolidated health check + +Bug Fixes +~~~~~~~~~ +| `POLICY-2845 `_ - Policy dockers contain GPLv3 +| `POLICY-3066 `_ - Stackoverflow error in APEX standalone after changing to onap java image +| `POLICY-3161 `_ - OOM clamp BE/FE do not start properly when clamp db exists in the cluster +| `POLICY-3174 `_ - POLICY-APEX log does not include the DATE in STDOUT +| `POLICY-3176 `_ - POLICY-DROOLS log does not include the DATE in STDOUT +| `POLICY-3177 `_ - POLICY-PAP log does not include the DATE in STDOUT +| `POLICY-3201 `_ - fix CRITICAL weak-cryptography issues identified in sonarcloud +| `POLICY-3202 `_ - PDP-D: no locking feature: service loader not locking the no-lock-manager +| `POLICY-3203 `_ - Update the PDP deployment in policy window failure +| `POLICY-3204 `_ - Clamp UI does not accept to deploy policy to PDP +| `POLICY-3205 `_ - The submit operation in Clamp cannot be achieved successfully +| `POLICY-3225 `_ - Clamp policy UI does not send right pdp command +| `POLICY-3226 `_ - Clamp policy UI does 2 parallel queries to policy list +| `POLICY-3248 `_ - PdpHeartbeats are not getting processed by PAP +| `POLICY-3301 `_ - Apex Avro Event Schemas - Not support for colon ':' character in field names +| `POLICY-3322 `_ - gui-editor-apex doesn't contain webapp correctly +| `POLICY-3332 `_ - Issues around delta policy deployment in APEX +| `POLICY-3369 `_ - Modify NSSI closed loop not running +| `POLICY-3445 `_ - Version conflicts in spring boot dependency jars in CLAMP +| `POLICY-3454 `_ - PDP-D CL APPS: swagger mismatched libraries cause telemetry shell to fail +| `POLICY-3468 `_ - PDPD-CL APPS: Clean up library transitive dependencies conflicts (jackson version) from new CDS libraries +| `POLICY-3507 `_ - CDS Operation Policy execution runtime error +| `POLICY-3526 `_ - OOM start of policy-distribution fails (keyStore values) +| `POLICY-3558 `_ - Delete Instance Properties if Instantiation is Unitialized +| `POLICY-3600 `_ - Some REST calls in Clamp GUI do not include pathname +| `POLICY-3601 `_ - Static web resource paths in gui-editor-apex are incorrect +| `POLICY-3602 `_ - Context schema table is not populated in Apex Editor +| `POLICY-3603 `_ - gui-pdp-monitoring broken in gui docker image +| `POLICY-3608 `_ - LASTUPDATE column in pdp table causing Nullpointer Exception in PAP initialization +| `POLICY-3610 `_ - PDP-D-APPS: audit and metric logging information is incorrect +| `POLICY-3611 `_ - "API,PAP: decrease eclipselink verbosity in persistence.xml" +| `POLICY-3625 `_ - Terminated PDPs are not being removed by PAP +| `POLICY-3637 `_ - Policy-mariadb connection intermittently fails from PF components +| `POLICY-3639 `_ - CLAMP_REST_URL environment variable is not needed +| `POLICY-3647 `_ - Cannot create Instance from Policy GUI +| `POLICY-3649 `_ - SSL Handshake failure between CL participants and DMaap +| `POLICY-3650 `_ - Disable apex-editor and pdp-monitoring in gui docker +| `POLICY-3660 `_ - DB-Migrator job completes even during failed upgrade +| `POLICY-3678 `_ - K8s participants tests are skipped due to json parsing error. +| `POLICY-3679 `_ - Modify pdpstatistics to prevent duplicate keys +| `POLICY-3680 `_ - PDP Monitoring GUI fails to parse JSON from PAP +| `POLICY-3682 `_ - Unable to list the policies in Policy UI +| `POLICY-3683 `_ - clamp-fe & policy-gui: useless rolling logs +| `POLICY-3684 `_ - Unable to select a PDP group & Subgroup when configuring a control loop policy +| `POLICY-3685 `_ - Fix CL state change issues in runtime and participants +| `POLICY-3686 `_ - Update Participant Status after Commissioning +| `POLICY-3687 `_ - Continuous sending CONTROL_LOOP_STATE_CHANGE message +| `POLICY-3688 `_ - Register participant in ParticipantRegister message +| `POLICY-3689 `_ - Handle ParticipantRegister +| `POLICY-3691 `_ - Problems Parsing Service Template +| `POLICY-3695 `_ - Tosca Constraint "in_range" not supported by policy/models +| `POLICY-3706 `_ - Telemetry not working in drools-pdp +| `POLICY-3707 `_ - Cannot delete a loop in design state + +References +========== + +For more information on the ONAP Istanbul 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`_ + .. ========================== .. * * * 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] `_ - Update the ENTRYPOINT in APEX-PDP Dockerfile + * `[POLICY-3066] `_ - Stackoverflow error in APEX standalone after changing to onap java image + * `[POLICY-3078] `_ - Support SSL communication in Kafka IO plugin of Apex-PDP + * `[POLICY-3173] `_ - APEX-PDP incorrectly reports successful policy deployment to PAP + * `[POLICY-3202] `_ - PDP-D: no locking feature: service loader not locking the no-lock-manager + * `[POLICY-3227] `_ - Implementation of context album improvements in apex-pdp + * `[POLICY-3230] `_ - Make default PDP-D and PDP-D-APPS work out of the box + * `[POLICY-3248] `_ - PdpHeartbeats are not getting processed by PAP + * `[POLICY-3301] `_ - Apex Avro Event Schemas - Not support for colon ':' character in field names + * `[POLICY-3305] `_ - Ensure XACML PDP application/translator methods are extendable + * `[POLICY-3331] `_ - PAP: should allow for external configuration of groups other than defaultGroup + * `[POLICY-3338] `_ - Upgrade CDS dependency to the latest version + * `[POLICY-3366] `_ - PDP-D: support configuration of overarching DMAAP https flag + * `[POLICY-3450] `_ - PAP should support turning on/off via configuration storing PDP statistics + * `[POLICY-3454] `_ - PDP-D CL APPS: swagger mismatched libraries cause telemetry shell to fail + * `[POLICY-3485] `_ - Limit statistics record count + * `[POLICY-3507] `_ - CDS Operation Policy execution runtime error + * `[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-08 (Honolulu Release) +:Release Date: 2021-04-29 (Honolulu Release) New features ============ @@ -147,7 +1299,6 @@ Quick Links: - `POLICY project page`_ - `Passing Badge information for POLICY`_ - .. ======================== .. * * * GUILIN * * * .. ======================== @@ -185,8 +1336,6 @@ Key Updates - 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 -* Multi-tenancy - - Basic initial support using the existing features * E2E Network Slicing - Added ModifyNSSI operation to SO actor * Consolidated health check