From 4a34fa546a3010fd04330194e6ea5296cad51587 Mon Sep 17 00:00:00 2001 From: lukegleeson Date: Mon, 19 Sep 2022 15:31:59 +0100 Subject: Update Release Notes for Kohn Added Jira tickets completed Updated Log Example in admin guide Updated timer property names for ncmp in deployment guide Issue-ID: CPS-1251 Signed-off-by: lukegleeson Change-Id: I20933d7d113bfa57937ec7f13ba3eb0ab6bc675a --- docs/admin-guide.rst | 17 ++++++------- docs/deployment.rst | 22 ++++++++-------- docs/release-notes.rst | 68 ++++++++++++++++++++++++++++++++++++++++++++------ 3 files changed, 80 insertions(+), 27 deletions(-) (limited to 'docs') diff --git a/docs/admin-guide.rst b/docs/admin-guide.rst index efa23b5035..eeac013773 100644 --- a/docs/admin-guide.rst +++ b/docs/admin-guide.rst @@ -34,15 +34,14 @@ CPS Log pattern { - "timestamp" : "%timestamp", // 2022-01-28 18:39:17.768 - "severity": "%level", // DEBUG - "service": "${springAppName}", // cps-application - "trace": "${TraceId}", // e17da1571e518c59 - "span": "${SpanId}", // e17da1571e518c59 - "pid": "${PID}", //11128 - "thread": "%thread", //tp1901272535-29 + "logTimeStamp" : "%timestamp", // 2022-01-28 18:39:17.768 + "logLevel": "%level", // DEBUG + "principalId": "%userId", // cpsuser + "serviceName": "${springAppName}", // cps-application + "message":"%message", // Execution time ... + "processId": "${PID}", //11128 + "threadName": "%thread", //tp1901272535-29 "class": "%logger{40}", .// o.onap.cps.aop.CpsLoggingAspectService - "rest": "%message" // Execution time ... } @@ -198,7 +197,7 @@ Prometheus Metrics can be checked at the following endpoint Naming Validation ----------------- -As part of the Jakarta 3.1.0 release, CPS has added validation to the names of the following components: +As part of the Kohn 3.1.0 release, CPS has added validation to the names of the following components: - Dataspace names - Schema Set names diff --git a/docs/deployment.rst b/docs/deployment.rst index 9c9a9ff7c4..82c54f12c6 100644 --- a/docs/deployment.rst +++ b/docs/deployment.rst @@ -197,8 +197,8 @@ Any spring supported property can be configured by providing in ``config.additio | logging.level | Logging level set in cps-core | info | | | | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ -| config.useStrimziKafka | If targeting a custom kafka cluster, ie useStrimziKakfa: false, the config.eventPublisher.spring.kafka | true | -| | values must be set. | | +| config.useStrimziKafka | If targeting a custom kafka cluster, ie useStrimziKafka: false, the config.eventPublisher.spring.kafka | true | +| | values below must be set. | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ | config.eventPublisher. | Kafka hostname and port | ``:9092`` | | spring.kafka.bootstrap-servers | | | @@ -251,7 +251,7 @@ Any spring supported property can be configured by providing in ``config.additio | enabled-dataspaces | | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ | config.additional. | If asynchronous messaging, user notifications, and updated event persistence should be enabled | ``true`` | -| notification.enabled | | | +| notification.data-updated.enabled | | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ | config.additional. | Core pool size in asynchronous execution of notification. | ``2`` | | notification.async.executor. | | | @@ -269,7 +269,7 @@ Any spring supported property can be configured by providing in ``config.additio | notification.async.executor. | | | | wait-for-tasks-to-complete-on-shutdown| | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ -| config.additional. | Prefix to be added to the thread name in asynchronous execution of notifications. | ``async_`` | +| config.additional. | Prefix to be added to the thread name in asynchronous execution of notifications. | ``Async-`` | | notification.async.executor. | | | | thread-name-prefix | | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ @@ -291,17 +291,17 @@ Additional CPS-NCMP Customizations | | | | | | See also :ref:`cps_common_credentials_retrieval`. | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ -| config.timers.advised-modules-sync | Specifies the delay in milliseconds in which the module sync watch dog will wake again after finishing. | ``30000`` | -| .sleep-time-ms | | | +| config.ncmp.timers | Specifies the delay in milliseconds in which the module sync watch dog will wake again after finishing. | ``30000`` | +| .advised-modules-sync.sleep-time-ms | | | | | | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ -| config.timers.locked-modules-sync | Specifies the delay in milliseconds in which the retry mechanism watch dog | | -| | will wake again after finishing. | ``300000`` | -| .sleep-time-ms | | | +| config.ncmp.timers | Specifies the delay in milliseconds in which the retry mechanism watch dog | | +| .locked-modules-sync.sleep-time-ms | will wake again after finishing. | ``300000`` | +| | | | | | | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ -| config.timers.cm-handle-data-sync | Specifies the delay in milliseconds in which the data sync watch dog will wake again after finishing. | ``30000`` | -| .sleep-time-ms | | | +| config.ncmp.timers | Specifies the delay in milliseconds in which the data sync watch dog will wake again after finishing. | ``30000`` | +| .cm-handle-data-sync.sleep-time-ms | | | | | | | +---------------------------------------+---------------------------------------------------------------------------------------------------------+-------------------------------+ diff --git a/docs/release-notes.rst b/docs/release-notes.rst index 46ffbb32b5..6752a40231 100755 --- a/docs/release-notes.rst +++ b/docs/release-notes.rst @@ -16,8 +16,8 @@ CPS Release Notes .. * * * KOHN * * * .. ==================== -Version: 3.1.0 (not released yet) -================================= +Version: 3.1.0 +============== Release Data ------------ @@ -32,19 +32,54 @@ Release Data | **Release designation** | 3.1.0 Kohn | | | | +--------------------------------------+--------------------------------------------------------+ -| **Release date** | N/A | +| **Release date** | 2022 September 14 | | | | +--------------------------------------+--------------------------------------------------------+ Features -------- - - `CPS-322 `_ Implement additional validation for names and identifiers - - `CPS-1136 `_ Get all cm handles by DMI plugin Identifier - - `CPS-1001 `_ Add CPS-E-05 endpoint for Read data, NCMP-Operational Datastore + - `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-1179 `_ Node API - GET method returns invalid response when identifier contains '/' + - `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 ----------------------------------------- @@ -54,6 +89,25 @@ Known Limitations, Issues and Workarounds 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 * * * .. ======================== -- cgit 1.2.3-korg