docs/release-notes.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3 .. Copyright (C) 2021 Nordix Foundation
   4
   5 .. DO NOT CHANGE THIS LABEL FOR RELEASE NOTES - EVEN THOUGH IT GIVES A WARNING
   6 .. _release_notes:
   7
   8
   9
  10 =================
  11 CPS Release Notes
  12 =================
  13
  14 .. contents::
  15     :depth: 2
  16 ..
  17
  18 ..      ========================
  19 ..      * * *   ISTANBUL   * * *
  20 ..      ========================
  21
  22 Version: 2.0.1
  23 ==============
  24
  25 Release Data
  26 ------------
  27
  28 +--------------------------------------+--------------------------------------------------------+
  29 | **CPS Project**                      |                                                        |
  30 |                                      |                                                        |
  31 +--------------------------------------+--------------------------------------------------------+
  32 | **Docker images**                    | onap/cps-and-ncmp:2.0.1                                |
  33 |                                      |                                                        |
  34 +--------------------------------------+--------------------------------------------------------+
  35 | **Release designation**              | 2.0.1 Istanbul                                         |
  36 |                                      |                                                        |
  37 +--------------------------------------+--------------------------------------------------------+
  38 | **Release date**                     | 2021-14-10                                             |
  39 |                                      |                                                        |
  40 +--------------------------------------+--------------------------------------------------------+
  41
  42 Bug Fixes
  43 ---------
  44
  45    - `CPS-594 <https://jira.onap.org/browse/CPS-594>`_ SQL ConstraintViolationException when updating the list node element using PATCH List node API
  46    - `CPS-653 <https://jira.onap.org/browse/CPS-653>`_ cmHandleProperties not supported by dmi in fetch modules
  47    - `CPS-673 <https://jira.onap.org/browse/CPS-673>`_ Improvement and cleanup for CPS Core charts
  48    - `CPS-691 <https://jira.onap.org/browse/CPS-691>`_ NCMP no master index label on index documentation page
  49
  50 Known Limitations, Issues and Workarounds
  51 -----------------------------------------
  52
  53 *System Limitations*
  54
  55 Limitations to the amount of child nodes that can be added to the fix above. The current limit is 3.
  56
  57 *Known Vulnerabilities*
  58
  59    - `CPS-725 <https://jira.onap.org/browse/CPS-725>`_ fix sample docker compose of cps/ncmp and onap dmi plugin
  60
  61 *Workarounds*
  62
  63 Add recursive method to save list node data to loop through all corresponding child nodes.
  64
  65 Security Notes
  66 --------------
  67
  68 *Fixed Security Issues*
  69
  70    - `CPS-581 <https://jira.onap.org/browse/CPS-581>`_ Remove security vulnerabilities
  71
  72 *Known Security Issues*
  73
  74 None
  75
  76 Version: 2.0.0
  77 ==============
  78
  79 Abstract
  80 --------
  81
  82 This document provides the release notes for Istanbul release.
  83
  84 Release Data
  85 ------------
  86
  87 +--------------------------------------+--------------------------------------------------------+
  88 | **CPS Project**                      |                                                        |
  89 |                                      |                                                        |
  90 +--------------------------------------+--------------------------------------------------------+
  91 | **Docker images**                    | onap/cps-and-ncmp:2.0.0                                |
  92 |                                      |                                                        |
  93 +--------------------------------------+--------------------------------------------------------+
  94 | **Release designation**              | 2.0.0 Istanbul                                         |
  95 |                                      |                                                        |
  96 +--------------------------------------+--------------------------------------------------------+
  97 | **Release date**                     | 2021-14-09                                             |
  98 |                                      |                                                        |
  99 +--------------------------------------+--------------------------------------------------------+
 100
 101 Features
 102 --------
 103 * Register DMI-Plugins with NCMP for CM Handle registrations.
 104 * Update, Create and Remove CM Handles.
 105 * Add support for retrieving and writing CM Handle data through NCMP datastores.
 106 * Automatic retrieval and caching of model information for CM Handles within NCMP.
 107
 108 Deliverables
 109 ------------
 110
 111 Software Deliverables
 112
 113 .. csv-table::
 114    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
 115    :widths: auto
 116
 117    "cps", "", "onap/cps-and-ncmp-proxy:2.0.0"
 118
 119 Bug Fixes
 120 ---------
 121
 122    - `CPS-310 <https://jira.onap.org/browse/CPS-310>`_ Data schema migration from Honolulu to Istanbul is failing
 123    - `CPS-316 <https://jira.onap.org/browse/CPS-316>`_ Xpath cannot be created for augmentation data node
 124    - `CPS-336 <https://jira.onap.org/browse/CPS-336>`_ Ends-with functionality in cpsPath does not conform with standard xPath behavior
 125    - `CPS-345 <https://jira.onap.org/browse/CPS-345>`_ Leaf String value comparison matches mix of single and double quotes
 126    - `CPS-357 <https://jira.onap.org/browse/CPS-357>`_ cps-review-verification-maven-master Jenkins job is failing when running csit test
 127    - `CPS-367 <https://jira.onap.org/browse/CPS-367>`_ Get descendent does not support xpaths that end in list values
 128    - `CPS-377 <https://jira.onap.org/browse/CPS-377>`_ Init ran model validation is failing error details are not provided
 129    - `CPS-422 <https://jira.onap.org/browse/CPS-422>`_ REST 404 response returned instead of 400 for POST/PUT/PATCH request types
 130    - `CPS-450 <https://jira.onap.org/browse/CPS-450>`_ Datanode query using full path to node causes NPE
 131    - `CPS-451 <https://jira.onap.org/browse/CPS-451>`_ cps-ran-schema-model@2021-01-28.yang missing root container
 132    - `CPS-464 <https://jira.onap.org/browse/CPS-464>`_ Request to update node leaves (patch) responds with Internal Server Error
 133    - `CPS-465 <https://jira.onap.org/browse/CPS-465>`_ Request to update node leaves (patch) responds with json parsing failure
 134    - `CPS-466 <https://jira.onap.org/browse/CPS-466>`_ Concurrent requests to create schema sets for the same yang model are not supported
 135    - `CPS-479 <https://jira.onap.org/browse/CPS-479>`_ Get Nodes API does not always return the object from the root
 136    - `CPS-500 <https://jira.onap.org/browse/CPS-500>`_ Special Character Limitations of cpsPath Queries
 137    - `CPS-501 <https://jira.onap.org/browse/CPS-501>`_ Put DataNode API has missing transaction and error handling for concurrency issues
 138    - `CPS-524 <https://jira.onap.org/browse/CPS-524>`_ Issue with CPSData API to add an item to an existing list node
 139    - `CPS-560 <https://jira.onap.org/browse/CPS-560>`_ Response from cps query using text() contains escape characters
 140    - `CPS-566 <https://jira.onap.org/browse/CPS-566>`_ Can't access grandparent node through ancestor axis
 141    - `CPS-573 <https://jira.onap.org/browse/CPS-573>`_ /v1/ch/PNFDemo1/modules returning 401 unauthorised.
 142    - `CPS-587 <https://jira.onap.org/browse/CPS-587>`_ cps-ncmp-service NullpointerException when DmiPluginRegistration has no additionProperties
 143    - `CPS-591 <https://jira.onap.org/browse/CPS-591>`_ CPS-Core Leaf stored as integer is being returned from DB as float
 144    - `CPS-601 <https://jira.onap.org/browse/CPS-601>`_ CPS swagger-ui does not show NCMP endpoints
 145    - `CPS-616 <https://jira.onap.org/browse/CPS-616>`_ NCMP base path does not conform to agreed API URL
 146    - `CPS-630 <https://jira.onap.org/browse/CPS-630>`_ Incorrect information sent when same anchor is updated faster than notification service processes
 147    - `CPS-635 <https://jira.onap.org/browse/CPS-635>`_ Module Resource call does not include body
 148
 149 This document provides the release notes for Istanbul release.
 150
 151 Summary
 152 -------
 153
 154 Following CPS components are available with default ONAP/CPS installation.
 155
 156
 157     * Platform components
 158
 159         - CPS (Helm charts)
 160
 161     * Service components
 162
 163         - CPS-NCMP
 164         - CPS-Temporal
 165         - DMI-Plugin
 166
 167     * Additional resources that CPS utilizes deployed using ONAP common charts
 168
 169         - Postgres Database
 170
 171
 172 Below service components (mS) are available to be deployed on-demand.
 173     - CPS-TBDMT
 174
 175
 176 Under OOM (Kubernetes) all CPS component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster.
 177
 178 Known Limitations, Issues and Workarounds
 179 -----------------------------------------
 180
 181 *System Limitations*
 182
 183 Limitations to the amount of child nodes that can be added to the fix above. The current limit is 3.
 184
 185 *Known Vulnerabilities*
 186
 187    - `CPS-594 <https://jira.onap.org/browse/CPS-594>`_ SQL ConstraintViolationException when updating the list node element using PATCH List node API
 188    - `CPS-653 <https://jira.onap.org/browse/CPS-653>`_ cmHandleProperties not supported by dmi in fetch modules
 189    - `CPS-673 <https://jira.onap.org/browse/CPS-673>`_ Improvement and cleanup for CPS Core charts
 190
 191 *Workarounds*
 192
 193 Add recursive method to save list node data to loop through all corresponding child nodes.
 194
 195 Security Notes
 196 --------------
 197
 198 *Fixed Security Issues*
 199
 200    - `CPS-249 <https://jira.onap.org/browse/CPS-249>`_ Exception stack trace is exposed
 201
 202 *Known Security Issues*
 203
 204    - `CPS-581 <https://jira.onap.org/browse/CPS-581>`_ Remove security vulnerabilities
 205
 206 Test Results
 207 ------------
 208     * `Integration tests`
 209
 210 ..      ========================
 211 ..      * * *   HONOLULU   * * *
 212 ..      ========================
 213
 214 Version: 1.0.1
 215 ==============
 216
 217 Release Data
 218 ------------
 219
 220 +--------------------------------------+--------------------------------------------------------+
 221 | **CPS Project**                      |                                                        |
 222 |                                      |                                                        |
 223 +--------------------------------------+--------------------------------------------------------+
 224 | **Docker images**                    | onap/cps-and-nf-proxy:1.0.1                            |
 225 |                                      |                                                        |
 226 +--------------------------------------+--------------------------------------------------------+
 227 | **Release designation**              | 1.0.1 Honolulu                                         |
 228 |                                      |                                                        |
 229 +--------------------------------------+--------------------------------------------------------+
 230 | **Release date**                     | 2021-04-09                                             |
 231 |                                      |                                                        |
 232 +--------------------------------------+--------------------------------------------------------+
 233
 234 Bug Fixes
 235 ---------
 236
 237    - `CPS-706 <https://jira.onap.org/browse/CPS-706>`_ Get moduleschema/yangresouce endpoint not working
 238    - `CPS-276 <https://jira.onap.org/browse/CPS-276>`_ Improve error reporting for invalid cpsPath on Queries
 239    - `CPS-288 <https://jira.onap.org/browse/CPS-288>`_ Move security configuration to the application module
 240    - `CPS-290 <https://jira.onap.org/browse/CPS-290>`_ Internal Server Error when creating the same data node twice
 241    - `CPS-292 <https://jira.onap.org/browse/CPS-292>`_ Detailed information is missing to explain why data is not compliant with the specified YANG model
 242    - `CPS-300 <https://jira.onap.org/browse/CPS-304>`_ Not able to create data instances for 2 different anchors using the same model
 243    - `CPS-304 <https://jira.onap.org/browse/CPS-304>`_ Use ONAP recommended base Java Docker image
 244    - `CPS-308 <https://jira.onap.org/browse/CPS-308>`_ Not able to upload yang models files greater than 1MB
 245
 246 Security Notes
 247 --------------
 248
 249 *Fixed Security Issues*
 250
 251    - `CPS-249 <https://jira.onap.org/browse/CPS-249>`_ Exception stack trace is exposed
 252
 253 *Known Security Issues*
 254
 255    - `Security Waiver <https://wiki.onap.org/display/DW/Honolulu+Exception+Request+for+CPS>`_ Security - Expose external endpoints with https
 256
 257 Version: 1.0.0
 258 ==============
 259
 260
 261 Abstract
 262 --------
 263
 264 This document provides the release notes for Honolulu release.
 265
 266 Summary
 267 -------
 268
 269 Following CPS components are available with default ONAP/CPS installation.
 270
 271
 272     * Platform components
 273
 274         - CPS (Helm charts)
 275
 276     * Service components
 277
 278         - CPS Core
 279
 280     * Additional resources that CPS utilizes deployed using ONAP common charts
 281
 282         - Postgres Database
 283
 284
 285 Below service components (mS) are available to be deployed on-demand.
 286     - CPS-TBDMT
 287
 288
 289 Under OOM (Kubernetes) all CPS component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster.
 290
 291
 292 Release Data
 293 ------------
 294
 295 +--------------------------------------+--------------------------------------------------------+
 296 | **CPS Project**                      |                                                        |
 297 |                                      |                                                        |
 298 +--------------------------------------+--------------------------------------------------------+
 299 | **Docker images**                    | Refer :any:`Deliverable <honolulu_deliverable>`        |
 300 |                                      |                                                        |
 301 +--------------------------------------+--------------------------------------------------------+
 302 | **Release designation**              | 1.0.0 Honolulu                                         |
 303 |                                      |                                                        |
 304 +--------------------------------------+--------------------------------------------------------+
 305 | **Release date**                     | 2021-03-11                                             |
 306 |                                      |                                                        |
 307 +--------------------------------------+--------------------------------------------------------+
 308
 309
 310 Features
 311 --------
 312 Configuration Persistence Service is a model driven persistence solution for data described by YANG models.
 313 CPS has been driven by the needs of the E2E Networking Slicing use case.
 314 It currently supports basic (rw) persistence and simple queries.
 315 It also provides MVP support for network data access using simulated data.
 316
 317 .. _honolulu_deliverable:
 318
 319 Deliverables
 320 ------------
 321
 322 Software Deliverables
 323
 324 .. csv-table::
 325    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
 326    :widths: auto
 327
 328    "cps", "", "onap/cps-and-nf-proxy:1.0.0"
 329
 330
 331 Known Limitations, Issues and Workarounds
 332 -----------------------------------------
 333
 334    - `CPS-249 <https://jira.onap.org/browse/CPS-249>`_ Exception stack trace is exposed
 335    - `CPS-264 <https://jira.onap.org/browse/CPS-264>`_ Unique timestamp is missing when tagging docker images.
 336    - Methods exposed on API which are yet not implemented : deleteAnchor, getNodesByDataspace & deleteDataspace.
 337    - `CPS-465 <https://jira.onap.org/browse/CPS-465>`_ & `CPS-464 <https://jira.onap.org/browse/CPS-464>`_ Update data node leaves API does not support updating a list element with compound keys.
 338
 339 *System Limitations*
 340
 341 None
 342
 343 *Known Vulnerabilities*
 344
 345 None
 346
 347 *Workarounds*
 348
 349 Documented under corresponding jira if applicable.
 350
 351 Security Notes
 352 --------------
 353
 354 *Fixed Security Issues*
 355
 356 * `CPS-167 <https://jira.onap.org/browse/CPS-167>`_ -Update CPS dependencies as Required for Honolulu release
 357     - Upgrade org.onap.oparent to 3.2.0
 358     - Upgrade spring.boot to 2.3.8.RELEASE
 359     - Upgrade yangtools to 5.0.7
 360
 361 *Known Security Issues*
 362
 363     * Weak Crytography using md5
 364     * Risk seen in Zip file expansion
 365
 366 *Known Vulnerabilities in Used Modules*
 367
 368     None
 369
 370 CPS code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, items that remain open have been assessed for risk and determined to be false positive.
 371
 372 Test Results
 373 ------------
 374     * `Integration tests <https://wiki.onap.org/display/DW/CPS+Integration+Test+Cases>`_
 375
 376 References
 377 ----------
 378
 379 For more information on the ONAP Honolulu release, please see:
 380
 381 #. `ONAP Home Page`_
 382 #. `ONAP Documentation`_
 383 #. `ONAP Release Downloads`_
 384 #. `ONAP Wiki Page`_
 385
 386
 387 .. _`ONAP Home Page`: https://www.onap.org
 388 .. _`ONAP Wiki Page`: https://wiki.onap.org
 389 .. _`ONAP Documentation`: https://docs.onap.org
 390 .. _`ONAP Release Downloads`: https://git.onap.org
 391
 392 Quick Links:
 393
 394         - `CPS project page <https://wiki.onap.org/pages/viewpage.action?pageId=71834216>`_
 395         - `Passing Badge information for CPS <https://bestpractices.coreinfrastructure.org/en/projects/4398>`_