X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Frelease-notes.rst;h=76e167f06017d84abcfe1a009b396f3864c460b8;hb=96c8e88e3750a16fa66d3f16ea0c84c0daf0be8f;hp=6e5d917ab453cf3cbe9501d99adfdb50cd1a8456;hpb=937e5f49b2593b225b7c444b98aa745833d509d6;p=cps.git diff --git a/docs/release-notes.rst b/docs/release-notes.rst index 6e5d917ab..76e167f06 100755 --- a/docs/release-notes.rst +++ b/docs/release-notes.rst @@ -1,24 +1,451 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -.. Copyright (C) 2021 Nordix Foundation +.. Copyright (C) 2021-2022 Nordix Foundation .. DO NOT CHANGE THIS LABEL FOR RELEASE NOTES - EVEN THOUGH IT GIVES A WARNING .. _release_notes: - - -================= CPS Release Notes -================= +################# .. contents:: :depth: 2 .. +.. ====================== +.. * * * LONDON * * * +.. ====================== + +Version: 3.2.1 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | (not yet released) | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.2.1 London | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +Features +-------- +3.2.1 + - `CPS-1236 `_ DMI audit support for NCMP: Filter on any properties of CM Handles + - `CPS-1187 `_ Added API to get all schema sets for a given dataspace. +3.2.0 + - `CPS-1185 `_ Get all dataspaces + - `CPS-1187 `_ Get single dataspace + +Bug Fixes +--------- +3.2.0 + - `CPS-1312 `_ CPS(/NCMP) does not have version control + - `CPS-1350 `_ [CPS/NCMP] Add Basic Auth to CPS/NCMP OpenAPI Definitions + +Known Limitations, Issues and Workarounds +----------------------------------------- + +*System Limitations* + +For upgrading, CPS uses Liquibase for database upgrades. CPS/NCMP currently only supports upgrading from Liquibase changelog 11 to Liquibase changelog 16. +This is from commit CPS-506: List all known modules and revision to CPS-1312: Default CMHandles to READY during upgrade or from ONAP release Honolulu to Kohn. + +.. ==================== +.. * * * KOHN * * * +.. ==================== + +Version: 3.1.4 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:3.1.4 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.1.4 Kohn | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 October 5 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + - `CPS-1265 `_ Revision field should not be required (NotNull) on cps-ri YangResourceEntity + - `CPS-1294 `_ Kafka communication fault caused cmHandle registration error + +Version: 3.1.3 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:3.1.3 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.1.3 Kohn | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 September 29 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + - None + +Version: 3.1.2 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:3.1.2 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.1.2 Kohn | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 September 28 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + - None + +Version: 3.1.1 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:3.1.1 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.1.1 Kohn | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 September 28 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + - None + +Security Notes +-------------- + +*Fixed Security Issues* + + - `CPS-1226 `_ Security bug in the logs + +Version: 3.1.0 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:3.1.0 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.1.0 Kohn | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 September 14 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Features +-------- + - `CPS-340 `_ Patch and update the root data node + - `CPS-575 `_ Write data for cmHandle using ncmp-datastores:passthrough-running (NCMP.) + - `CPS-731 `_ Query based on Public CM Properties + - `CPS-828 `_ Async: NCMP Rest impl. including Request ID generation + - `CPS-829 `_ Async: Internal message topic incl. basic producer & Consumer + - `CPS-830 `_ DMI-NCMP Asynchronously Publish Response Event to Client Topic + - `CPS-869 `_ Apply Standardized logging fields to adhere to ONAP Best practice REQ-1072 + - `CPS-870 `_ Align CPS-Core output with SDN-C output (add module name) + - `CPS-875 `_ CM Handle State: Watchdog-process that syncs 'ADVISED' CM Handles + - `CPS-877 `_ CM Handle State: Exclude any CM-Handles from queries/operations that are not in state 'READY' + - `CPS-899 `_ Start and stop sessions on Java API + - `CPS-909 `_ Separate NCMP endpoint for ch/{cm-handle}/properties and ch/{cm-handle}/state + - `CPS-917 `_ Structured Errors response for passthrough use-cases in NCMP + - `CPS-953 `_ Update maven deploy plugin version + - `CPS-977 `_ Query CM Handles using CpsPath + - `CPS-1000 `_ Create Data Synchronization watchdog + - `CPS-1016 `_ Merge 2 'query' end points in NCMP + - `CPS-1034 `_ Publish lifecycle events for ADVISED , READY and LOCKED state transition" + - `CPS-1064 `_ Support retrieval of YANG module sources for CM handle on the NCMP interface + - `CPS-1099 `_ Expose simplified 'external' lock reason enum state over REST interface + - `CPS-1101 `_ Introducing the DELETING and DELETED Cmhandle State + - `CPS-1102 `_ Register the Cmhandle Sends Advised State notification. + - `CPS-1133 `_ Enable/Disable Data Sync for Cm Handle + - `CPS-1136 `_ DMI Audit Support (get all CM Handles for a registered DMI) + + +Bug Fixes +--------- + - `CPS-896 `_ CM Handle Registration Process only partially completes when exception is thrown + - `CPS-957 `_ NCMP: fix getResourceDataForPassthroughOperational endpoint + - `CPS-1020 `_ DuplicatedYangResourceException error at parallel cmHandle registration + - `CPS-1056 `_ Wrong error response format in case of Dmi plugin error + - `CPS-1067 `_ NCMP returns 500 error on searches endpoint when No DMi Handles registered + - `CPS-1085 `_ Performance degradation on ncmp/v1/ch/searches endpoint + - `CPS-1088 `_ Kafka consumer can not be turned off + - `CPS-1097 `_ Unable to change state from LOCKED to ADVISED + - `CPS-1126 `_ CmHandle creation performance degradation + - `CPS-1175 `_ Incorrect response when empty body executed for cmhandle id-searches + - `CPS-1179 `_ Node API - GET method returns invalid response when identifier contains '/' + - `CPS-1212 `_ Additional Properties for CM Handles not included when send to DMI Plugin + - `CPS-1217 `_ Searches endpoint gives back empty list however there are already available cmhandles + - `CPS-1218 `_ NCMP logs are flooded with SyncUtils logs + +Known Limitations, Issues and Workarounds +----------------------------------------- + +*System Limitations* + +Having '[' token in any index in any list will have a negative impact on the search functions leaf-conditions and text()-condition. +Example of an xpath that would cause problems while using cps-path queries : /parent/child[@id='id[with]braces'] + +*Known Vulnerabilities* + +None + +*Workarounds* + +None + +Security Notes +-------------- + +*Fixed Security Issues* + + - `CPS-963 `_ Liquibase has got serious vulnerability, upgrade required + +*Known Security Issues* + +None + +.. ======================== +.. * * * JAKARTA * * * +.. ======================== + +Version: 3.0.1 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:3.0.1 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.0.1 Jakarta | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 April 28 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + - `CPS-961 `_ Updated ANTLR compiler version to 4.9.2 to be compatible with runtime version + +Version: 3.0.0 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:3.0.0 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 3.0.0 Jakarta | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 March 15 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Features +-------- + - `CPS-559 `_ Define response objects (schemas) in cps-ncmp + - `CPS-636 `_ Update operation for datastore pass through running + - `CPS-638 `_ Delete operation for datastore pass through running + - `CPS-677 `_ Support 'public' Cm Handle Properties + - `CPS-741 `_ Re sync after removing cm handles + - `CPS-777 `_ Ensure all DMI operations use POST method + - `CPS-780 `_ Add examples for parameters, request and response in openapi yaml for cps-core + - `CPS-789 `_ CPS Data Updated Event Schema V2 to support delete operation + - `CPS-791 `_ CPS-Core sends delete notification event + - `CPS-817 `_ Create Endpoint For Get Cm Handles (incl. public properties) By Name + - `CPS-837 `_ Add Remove and Update properties (DMI and Public) as part of CM Handle Registration update + +Bug Fixes +--------- + + - `CPS-762 `_ Query cm handles for module names returns incorrect cm handle identifiers + - `CPS-788 `_ Yang Resource formatting is incorrect + - `CPS-783 `_ Remove cm handle does not completely remove all cm handle information + - `CPS-841 `_ Upgrade log4j to 2.17.1 as recommended by ONAP SECCOM + - `CPS-856 `_ Retry mechanism not working for concurrent CmHandle registration + - `CPS-867 `_ Database port made configurable through env variable DB_PORT + - `CPS-886 `_ Fragment handling decreasing performance for large number of cmHandles + - `CPS-887 `_ Increase performance of cmHandle registration for large number of schema sets in DB + - `CPS-892 `_ Fixed the response code during CM-Handle Registration from 201 CREATED to 204 NO_CONTENT + - `CPS-893 `_ NCMP Java API depends on NCM-Rest-API (cyclic) through json properties on Java API + +Known Limitations, Issues and Workarounds +----------------------------------------- + +*System Limitations* + +Null can no longer be passed within the dmi plugin service names when registering a cm handle, as part of +`CPS-837 `_ null is now used to indicate if a property should be removed as part +of cm handle registration. + +The Absolute path to list with integer key will not work. Please refer `CPS-961 `_ +for more information. + +*Known Vulnerabilities* + +None + +*Workarounds* + +Instead of passing null as a value within the dmi plugin service names, remove them from the request completely, or +pass an empty string as the value if you do not want to include names for these values. + +Security Notes +-------------- + +*Fixed Security Issues* + +None + +*Known Security Issues* + +None + .. ======================== .. * * * ISTANBUL * * * .. ======================== +Version: 2.0.4 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:2.0.4 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 2.0.4 Istanbul | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022 Feb 09 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + + - `CPS-879 `_ Fix docker compose for csit test. + - `CPS-873 `_ Fix intermittent circular dependency error when the application starts. + +Version: 2.0.3 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:2.0.3 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 2.0.3 Istanbul | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2022-07-01 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + + - `CPS-841 `_ Update log4j version to 2.17.1 due to security vulnerability + +Version: 2.0.2 +============== + +Release Data +------------ + ++--------------------------------------+--------------------------------------------------------+ +| **CPS Project** | | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Docker images** | onap/cps-and-ncmp:2.0.2 | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release designation** | 2.0.2 Istanbul | +| | | ++--------------------------------------+--------------------------------------------------------+ +| **Release date** | 2021-16-12 | +| | | ++--------------------------------------+--------------------------------------------------------+ + +Bug Fixes +--------- + + - `CPS-820 `_ Update log4j version due to security vulnerability + Version: 2.0.1 ============== @@ -141,7 +568,7 @@ Bug Fixes - `CPS-573 `_ /v1/ch/PNFDemo1/modules returning 401 unauthorised. - `CPS-587 `_ cps-ncmp-service NullpointerException when DmiPluginRegistration has no additionProperties - `CPS-591 `_ CPS-Core Leaf stored as integer is being returned from DB as float - - `CPS-601 `_ CPS swagger-ui does not show NCMP endpoints + - `CPS-601 `_ CPS swagger-ui does not show NCMP endpoints - `CPS-616 `_ NCMP base path does not conform to agreed API URL - `CPS-630 `_ Incorrect information sent when same anchor is updated faster than notification service processes - `CPS-635 `_ Module Resource call does not include body @@ -234,6 +661,7 @@ Release Data Bug Fixes --------- + - `CPS-706 `_ Get moduleschema/yangresouce endpoint not working - `CPS-276 `_ Improve error reporting for invalid cpsPath on Queries - `CPS-288 `_ Move security configuration to the application module - `CPS-290 `_ Internal Server Error when creating the same data node twice