docs/sections/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) 2017-2022 AT&T Intellectual Property. All rights reserved.
   4 .. Copyright 2021 Nokia Solutions and Networks.
   5 .. _release_notes:
   6
   7
   8
   9 ==================
  10 DCAE Release Notes
  11 ==================
  12
  13 .. contents::
  14     :depth: 2
  15 ..
  16
  17
  18 ..      =====================================
  19 ..      * * *    ISTANBUL  MAINTENANCE  * * *
  20 ..      =====================================
  21
  22
  23 Version: 9.0.1
  24 ==============
  25
  26 Abstract
  27 --------
  28
  29 This document provides the release notes for the Istanbul Maintenance release
  30
  31
  32 Summary
  33 -------
  34
  35 This maintenance release is primarily to resolve bugs identified during Istanbul release testing.
  36
  37
  38 Release Data
  39 ------------
  40
  41 +--------------------------------------+--------------------------------------+
  42 | **Project**                          | DCAE                                 |
  43 |                                      |                                      |
  44 +--------------------------------------+--------------------------------------+
  45 | **Docker images**                    | See Istanbul Maintenance Release     |
  46 |                                      |         Deliverable (below)          |
  47 +--------------------------------------+--------------------------------------+
  48 | **Release designation**              | Istanbul Maintenance Release         |
  49 |                                      |                                      |
  50 +--------------------------------------+--------------------------------------+
  51 | **Release date**                     | 2022/01/31                           |
  52 |                                      |                                      |
  53 +--------------------------------------+--------------------------------------+
  54
  55 New features
  56 ------------
  57
  58 None
  59
  60 **Bug fixes**
  61
  62 - `DCAEGEN2-3022 <https://jira.onap.org/browse/DCAEGEN2-3022>`_ Log4j vulnerability fix
  63 - `DCAEGEN2-2998 <https://jira.onap.org/browse/DCAEGEN2-2998>`_ Update SON-Handler missing configuration in helm
  64
  65
  66 **Known Issues**
  67
  68 None
  69
  70 Istanbul Maintenance Rls Deliverables
  71 -------------------------------------
  72
  73 Software Deliverables
  74
  75 .. csv-table::
  76    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
  77    :widths: auto
  78
  79    "dcaegen2/collectors/restconf", "", "onap/org.onap.dcaegen2.collectors.restconfcollector:1.2.7"
  80    "dcaegen2/collectors/ves", "", "onap/org.onap.dcaegen2.collectors.ves.vescollector:1.10.3"
  81    "dcaegen2/services/mapper", "", "onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.3.2"
  82
  83
  84
  85 ..      ==========================
  86 ..      * * *    ISTANBUL    * * *
  87 ..      ==========================
  88
  89
  90 Version: 9.0.0
  91 ==============
  92
  93
  94 Abstract
  95 --------
  96
  97 This document provides the release notes for Istanbul release.
  98
  99 Summary
 100 -------
 101
 102 Following DCAE components are available with default ONAP/DCAE installation.
 103
 104     - Platform components
 105
 106         - Cloudify Manager (helm chart)*
 107         - Bootstrap container (helm chart)*
 108         - Configuration Binding Service (helm chart)
 109         - Deployment Handler (helm chart)*
 110         - Policy Handler (helm chart*
 111         - Service Change Handler (helm chart)*
 112         - Inventory API (helm chart)*
 113         - Dashboard (helm chart)*
 114         - VES OpenAPI Manager (helm chart)
 115
 116     - Service components
 117
 118         - VES Collector (helm chart  & cloudify blueprint)
 119         - HV-VES Collector (helm chart  & cloudify blueprint)
 120         - PNF-Registration Handler  (helm chart  & cloudify blueprint)
 121         - Docker based Threshold Crossing Analytics (TCA-Gen2) (helm chart  & cloudify blueprint)
 122
 123     - Additional resources that DCAE utilizes deployed using ONAP common charts:
 124
 125         - Postgres Database
 126         - Mongo Database
 127         - Consul Cluster
 128
 129     \*  These components will be retired next ONAP release as cloudify deployments will be diabled after Istanbul.
 130
 131
 132 Below service components (mS) are available to be deployed on-demand (helm chart & Cloudify Blueprint)
 133
 134         - SNMPTrap Collector
 135         - RESTConf Collector
 136         - DataFile Collector
 137         - PM-Mapper
 138         - BBS-EventProcessor
 139         - VES Mapper
 140         - Heartbeat mS
 141         - SON-Handler
 142         - PM-Subscription Handler
 143         - DataLake Handler (Admin and Feeder)
 144         - Slice Analysis mS
 145         - DataLake Extraction Service
 146         - KPI-Ms
 147
 148
 149 Under OOM all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster.
 150 With DCAE tranformation to Helm in Istanbul release - all DCAE components are available to be deployed under Helm; Cloudify blueprint deployment is provided for backward compatibility support in this release.
 151
 152 For Helm managed microservices, the dependencies/pre-requisite are identified on each charts individually. In general, most DCAE microservice rely on Consul/Configbindingservice for sourcing configuration updates (this dependency will be removed in next release). Each microservice can be deployed independently and based on dcaegen2-services-common template, features can be enabled or disabled via configuration override during deployment. For list of supported features in helm refer - :doc:`Using Helm to deploy DCAE Microservices <./dcaeservice_helm_template>`.
 153
 154 DCAE continues to provides Cloudify deployment through plugins (cloudify) that is capable of expanding a Cloudify blueprint node specification for a service component to a full Kubernetes specification, with additional enhancements such as replica scaling, sidecar for logging to ONAP ELK stack.
 155
 156
 157 Release Data
 158 ------------
 159
 160 +--------------------------------------+--------------------------------------------------------+
 161 | **DCAE Project**                     |                                                        |
 162 |                                      |                                                        |
 163 +--------------------------------------+--------------------------------------------------------+
 164 | **Docker images**                    | Refer :any:`Deliverable <istanbul_deliverable>`        |
 165 |                                      |                                                        |
 166 +--------------------------------------+--------------------------------------------------------+
 167 | **Release designation**              | 9.0.0 Istanbul                                         |
 168 |                                      |                                                        |
 169 +--------------------------------------+--------------------------------------------------------+
 170 | **Release date**                     | 2021-11-18                                             |
 171 |                                      |                                                        |
 172 +--------------------------------------+--------------------------------------------------------+
 173
 174
 175 New features
 176 ------------
 177
 178
 179
 180 *DCAE Enhancements Features*
 181
 182
 183 DCAEGEN2-2771 DCAE Impacts for E2E Network Slicing in Istanbul release
 184     - Enhance SliceAnalysis and KPI-Computation MS to interface with CPS; integration with new CBS client SDK and support policy sidecar
 185
 186 DCAEGEN2-2703 Add stndDefined domain to HV-VES
 187         - Adapt HV_VES to support stdDefined domain instroduced under VES7.2.1 spec
 188
 189 DCAEGEN2-2630 DCAE Helm Transformation (Phase 2)
 190         - Since Honolulu, 13 additional MS has been delivered for Helm deployment
 191         - DCAE Service helm deployment is supported through implementing common functions as named template/functions defined in dcaegen2-services-common charts. Several new common features has been added in generic fashion and components/mS can enable required features via configuration override
 192                         - K8S Secret/Environment mapping
 193                         - CMPv2 Certificate support
 194                         - Policy Sidecar
 195                         - Mount data from configmap through PV/PVC
 196                         - Topic/feed provisioning support
 197         - SDK Libraries (java and python) has been enhanced to support configuration retrieval from files
 198         - Helm-generator tool available for generating DCAE component helm-chart given component spec
 199
 200 DCAEGEN2-2541 Bulk PM (PMSH) - Additional use cases, deployment and documentation enhancements
 201         - Enhanced PMSH Microservice to support subscription property updates, config updates to support 'n' subscriptions, support resource name in filter
 202
 203 DCAEGEN2-2522 Enhancements for OOF SON use case
 204         - Implemented CPS client and switched to new CBS client SDK for removing consul dependency and enabling policy configuration through sidecar.
 205
 206 Non-Functional
 207
 208    - Removed GPLv3 license from software by switching to onap/integration base images (DCAEGEN2-2455)
 209    - CII Badging improvements (DCAEGEN2-2622)
 210    - Healthcheck container Py3 upgrade  (DCAEGEN2-2737)
 211    - Vulnerability updates for several DCAE MS (TCA-gen2, DataFileCollector,RESTConf, VES,Mapper, PM-Mapper, PRH, SON-handler, KPI-MS, Slice-Analysis MS) (DCAEGEN2-2768)
 212
 213
 214 Bug Fixes
 215
 216    - BPGenerator yaml Fixes are different for yaml file and string (DCAEGEN2-2489)
 217    - Slice Analysis - Avoid removal of data when insufficient samples are present (DCAEGEN2-2509)
 218
 219
 220
 221 .. _istanbul_deliverable:
 222
 223 Deliverables
 224 ------------
 225
 226 Software Deliverables
 227
 228 .. csv-table::
 229    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
 230    :widths: auto
 231
 232    "dcaegen2/analytics/tca-gen2", "", "onap/org.onap.dcaegen2.analytics.tca-gen2.dcae-analytics-tca-web:1.3.1"
 233    "dcaegen2/collectors/datafile", "", "onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.6.1"
 234    "dcaegen2/collectors/hv-ves", "", "onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.9.1"
 235    "dcaegen2/collectors/restconf", "", "onap/org.onap.dcaegen2.collectors.restconfcollector:1.2.5"
 236    "dcaegen2/collectors/snmptrap", "", "onap/org.onap.dcaegen2.collectors.snmptrap:2.0.5"
 237    "dcaegen2/collectors/ves", "", "onap/org.onap.dcaegen2.collectors.ves.vescollector:1.10.1"
 238    "dcaegen2/deployments", "cm-container", "onap/org.onap.dcaegen2.deployments.cm-container:4.6.1"
 239    "dcaegen2/deployments", "consul-loader-container", "onap/org.onap.dcaegen2.deployments.consul-loader-container:1.1.1"
 240    "dcaegen2/deployments", "dcae-k8s-cleanup-container", "onap/org.onap.dcaegen2.deployments.dcae-k8s-cleanup-container:1.0.0"
 241    "dcaegen2/deployments", "healthcheck-container", "onap/org.onap.dcaegen2.deployments.healthcheck-container:2.2.0"
 242    "dcaegen2/deployments", "tls-init-container", "onap/org.onap.dcaegen2.deployments.tls-init-container:2.1.0"
 243    "dcaegen2/deployments", "dcae-services-policy-sync", "onap/org.onap.dcaegen2.deployments.dcae-services-policy-sync:1.0.1"
 244    "dcaegen2/platform", "mod/onboardingapi", "onap/org.onap.dcaegen2.platform.mod.onboardingapi:2.12.5"
 245    "dcaegen2/platform", "mod/distributorapi", "onap/org.onap.dcaegen2.platform.mod.distributorapi:1.1.0"
 246    "dcaegen2/platform", "mod/designtool", "onap/org.onap.dcaegen2.platform.mod.designtool-web:1.0.2"
 247    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-http:1.0.2"
 248    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-job:1.0.2"
 249    "dcaegen2/platform", "mod/designtool/mod-registry", "onap/org.onap.dcaegen2.platform.mod.mod-registry:1.0.0"
 250    "dcaegen2/platform", "mod/runtimeapi", "onap/org.onap.dcaegen2.platform.mod.runtime-web:1.2.3"
 251    "dcaegen2/platform", "adapter/acumos", "onap/org.onap.dcaegen2.platform.adapter.acumos:1.0.6"
 252    "dcaegen2/platform/blueprints", "", "onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:3.3.5"
 253    "dcaegen2/platform/configbinding", "", "onap/org.onap.dcaegen2.platform.configbinding:2.5.4"
 254    "dcaegen2/platform/deployment-handler", "", "onap/org.onap.dcaegen2.platform.deployment-handler:4.4.1"
 255    "dcaegen2/platform/inventory-api", "", "onap/org.onap.dcaegen2.platform.inventory-api:3.5.2"
 256    "dcaegen2/platform/policy-handler", "", "onap/org.onap.dcaegen2.platform.policy-handler:5.1.3"
 257    "dcaegen2/platform/servicechange-handler", "", "onap/org.onap.dcaegen2.platform.servicechange-handler:1.4.0"
 258    "dcaegen2/platform/ves-openapi-manager", "", "onap/org.onap.dcaegen2.platform.ves-openapi-manager:1.0.1"
 259    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakefeeder:1.1.1"
 260    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakeadminui:1.1.1"
 261    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalake.exposure.service:1.1.1"
 262    "dcaegen2/services", "components/pm-subscription-handler", "onap/org.onap.dcaegen2.services.pmsh:1.3.2"
 263    "dcaegen2/services", "components/slice-analysis-ms", "onap/org.onap.dcaegen2.services.components.slice-analysis-ms:1.0.6"
 264    "dcaegen2/services", "components/bbs-event-processor", "onap/org.onap.dcaegen2.services.components.bbs-event-processor:2.1.1"
 265    "dcaegen2/services", "components/kpi-ms", "onap/org.onap.dcaegen2.services.components.kpi-ms:1.0.1"
 266    "dcaegen2/services/heartbeat", "", "onap/org.onap.dcaegen2.services.heartbeat:2.3.1"
 267    "dcaegen2/services/mapper", "", "onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.3.0"
 268    "dcaegen2/services/pm-mapper", "", "onap/org.onap.dcaegen2.services.pm-mapper:1.7.2"
 269    "dcaegen2/services/prh", "", "onap/org.onap.dcaegen2.services.prh.prh-app-server:1.7.1"
 270    "dcaegen2/services/son-handler", "", "onap/org.onap.dcaegen2.services.son-handler:2.1.5"
 271    "dcaegen2/platform", "mod/bpgenerator", "Blueprint Generator 1.8.0 (jar)"
 272    "dcaegen2/services/sdk", "", "DCAE SDK 1.8.7 (jar)"
 273    "ccsdk/dashboard", "", "onap/org.onap.ccsdk.dashboard.ccsdk-app-os:1.4.4"
 274
 275
 276 Known Limitations, Issues and Workarounds
 277 -----------------------------------------
 278
 279 DCAEGEN2-2861 - Topic/feed provisioned through Helm require manual cleanup once the helm deployed service are uninstalled.
 280 Refer following document  :doc:`Using Helm to deploy DCAE Microservices <./dcaeservice_helm_template>` for steps to remove topic/feed provisioned in DMAAP.
 281
 282
 283 *Known Vulnerabilities*
 284
 285 None
 286
 287 *Workarounds*
 288
 289 Documented under corresponding jira if applicable.
 290
 291 Security Notes
 292 --------------
 293
 294 *Fixed Security Issues*
 295
 296     Documented on earlier section
 297
 298 *Known Security Issues*
 299
 300     None
 301
 302 *Known Vulnerabilities in Used Modules*
 303
 304     None
 305
 306 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_.
 307
 308 Test Results
 309 ------------
 310
 311  - `DCAE R9 Pairwise Test <https://wiki.onap.org/display/DW/DCAE+Pair+Wise+Testing+for+Istanbul+Release>`_
 312  - `DCAE R9 Functional Test <https://wiki.onap.org/display/DW/DCAE+R9+Testplan>`_
 313
 314
 315 References
 316 ----------
 317
 318 For more information on the ONAP Honolulu release, please see:
 319
 320 #. `ONAP Home Page`_
 321 #. `ONAP Documentation`_
 322 #. `ONAP Release Downloads`_
 323 #. `ONAP Wiki Page`_
 324
 325
 326 .. _`ONAP Home Page`: https://www.onap.org
 327 .. _`ONAP Wiki Page`: https://wiki.onap.org
 328 .. _`ONAP Documentation`: https://docs.onap.org
 329 .. _`ONAP Release Downloads`: https://git.onap.org
 330
 331 Quick Links:
 332
 333         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 334         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 335
 336
 337 ..      =====================================
 338 ..      * * *    HONOLULU  MAINTENANCE  * * *
 339 ..      =====================================
 340
 341
 342 Version: 8.0.1
 343 ==============
 344
 345 Abstract
 346 --------
 347
 348 This document provides the release notes for the Honolulu Maintenance release
 349
 350
 351 Summary
 352 -------
 353
 354 This maintenance release is primarily to resolve bugs identified during Honolulu release testing.
 355
 356
 357 Release Data
 358 ------------
 359
 360 +--------------------------------------+--------------------------------------+
 361 | **Project**                          | DCAE                                 |
 362 |                                      |                                      |
 363 +--------------------------------------+--------------------------------------+
 364 | **Docker images**                    | onap/org.onap.ccsdk.dashboard.       |
 365 |                                      |   .ccsdk-app-os:1.4.4                |
 366 +--------------------------------------+--------------------------------------+
 367 | **Release designation**              | Honolulu Maintenance Release         |
 368 |                                      |                                      |
 369 +--------------------------------------+--------------------------------------+
 370 | **Release date**                     | 2021/06/01                           |
 371 |                                      |                                      |
 372 +--------------------------------------+--------------------------------------+
 373
 374 New features
 375 ------------
 376
 377 None
 378
 379 **Bug fixes**
 380
 381 - `DCAEGEN2-2751 <https://jira.onap.org/browse/DCAEGEN2-2751>`_ Dashboard login issue due to oom/common PG upgrade to centos8-13.2-4.6.1
 382 - `CCSDK-3233 <https://jira.onap.org/browse/CCSDK-3233>`_ Switch to integration base image & vulnerability updates fixes
 383 - `DCAEGEN2-2800 <https://jira.onap.org/browse/DCAEGEN2-2800>`_ DCAE Healthcheck failure due to Dashboard
 384 - `DCAEGEN2-2869 <https://jira.onap.org/browse/DCAEGEN2-2869>`_ Fix PRH aai lookup url config
 385
 386 **Known Issues**
 387
 388 None
 389
 390 ..      ==========================
 391 ..      * * *    HONOLULU    * * *
 392 ..      ==========================
 393
 394
 395 Version: 8.0.0
 396 ==============
 397
 398
 399 Abstract
 400 --------
 401
 402 This document provides the release notes for Honolulu release.
 403
 404 Summary
 405 -------
 406
 407 Following DCAE components are available with default ONAP/DCAE installation.
 408
 409     - Platform components
 410
 411         - Cloudify Manager (helm chart)
 412         - Bootstrap container (helm chart)
 413         - Configuration Binding Service (helm chart)
 414         - Deployment Handler (helm chart)
 415         - Policy Handler (helm chart
 416         - Service Change Handler (helm chart)
 417         - Inventory API (helm chart)
 418         - Dashboard (helm chart)
 419         - VES OpenAPI Manager (helm chart)
 420
 421     - Service components
 422
 423         - VES Collector (helm chart  & cloudify blueprint)
 424         - HV-VES Collector (helm chart  & cloudify blueprint)
 425         - PNF-Registration Handler  (helm chart  & cloudify blueprint)
 426         - Docker based Threshold Crossing Analytics (TCA-Gen2) (helm chart  & cloudify blueprint)
 427         - Holmes Rule Management (helm chart  & cloudify blueprint)
 428         - Holmes Engine Management (helm chart  & cloudify blueprint)
 429
 430     - Additional resources that DCAE utilizes deployed using ONAP common charts:
 431
 432         - Postgres Database
 433         - Mongo Database
 434         - Consul Cluster
 435
 436 Below service components (mS) are available to be deployed on-demand (through Cloudify Blueprint)
 437
 438         - SNMPTrap Collector
 439         - RESTConf Collector
 440         - DataFile Collector
 441         - PM-Mapper
 442         - BBS-EventProcessor
 443         - VES Mapper
 444         - Heartbeat mS
 445         - SON-Handler
 446         - PM-Subscription Handler
 447         - DataLake Handler (Admin and Feeder)
 448         - Slice Analysis mS
 449         - DataLake Extraction Service
 450         - KPI-Ms
 451
 452     Notes:
 453
 454         \*  These components are delivered by the Holmes project.
 455
 456
 457
 458 Under OOM (Kubernetes) all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster. DCAE components are deployed using combination of Helm charts and Cloudify blueprint as noted above. DCAE provides a Cloudify Manager plugin (k8splugin) that is capable of expanding a Cloudify blueprint node specification for a service component to a full Kubernetes specification, with additional enhancements such as replica scaling, sidecar for logging to ONAP ELK stack, registering services to MSB, etc.
 459
 460
 461 Release Data
 462 ------------
 463
 464 +--------------------------------------+--------------------------------------------------------+
 465 | **DCAE Project**                     |                                                        |
 466 |                                      |                                                        |
 467 +--------------------------------------+--------------------------------------------------------+
 468 | **Docker images**                    | Refer :any:`Deliverable <honolulu_deliverable>`        |
 469 |                                      |                                                        |
 470 +--------------------------------------+--------------------------------------------------------+
 471 | **Release designation**              | 8.0.0 Honolulu                                         |
 472 |                                      |                                                        |
 473 +--------------------------------------+--------------------------------------------------------+
 474 | **Release date**                     | 2021-04-29                                             |
 475 |                                      |                                                        |
 476 +--------------------------------------+--------------------------------------------------------+
 477
 478
 479 New features
 480 ------------
 481
 482 *DCAE Enhancements*
 483
 484
 485 Functional Updates
 486
 487    - New service VES-Openapi-Manager component added to DCAE, allowing to notify of missing openAPI description, at xNF distribution phase (DCAEGEN2-2571)
 488    - Added VES 7.2.1 support in VESCollector (DCAEGEN2-2539, DCAEGEN2-2477)
 489    - DCAE MS deployment through helm with introduction of common dcae-service template to standardize charts with migration (DCAEGEN2-2488)
 490    - New service KPI-Computation MS introduced for support for E2E Slicing Usecase (DCAEGEN2-2521)
 491    - K8S configMap support through onboarding/design/deployment via DCAE-MOD and DCAE-Platform (DCAEGEN2-2539)
 492    - BP-generation Enhancements - support Native-kafka & Config-map through onboarding (DCAEGEN2-2458)
 493    - CFY plugin enhancements - support IPV6 service exposure + Config-Map + Cert-Manager's CMPv2 issuer integration (DCAEGEN2-2539, DCAEGEN2-2458, DCAEGEN2-2388)
 494    - DCAE SDK enhancement - Dmaap Client update for timeout/retry + CBS client update (DCAEGEN2-1483)
 495    - DFC enhancement - support in HTTP/HTTPS/enroll certificate from CMPv2 server (DCAEGEN2-2517)
 496
 497 Non-Functional
 498
 499    - DCAE Cloudify py3 upgrade including plugins/bootstrap cli (DCAEGEN2-1546)
 500    - CII Badging improvements (DCAEGEN2-2570)
 501    - Policy-Handler Py3 upgrade  (DCAEGEN2-2494)
 502    - Vulnerability updates for several DCAE MS (DataFile Collector, RESTConf, VESCollector, InventoryAPI, MOD/RuntimeAPI, VES-mapper, PM-Mapper, PRH, SON-Handler) (DCAEGEN2-2551)
 503    - Code Coverage improvement (DataFile, SDK, Blueprint-generator, Plugins, Acumos Adapter) (DCAEGEN2-2382)
 504    - Documentation/user-guide updates
 505
 506 Bug Fixes
 507
 508    - BPGenerator yaml Fixes are different for yaml file and string (DCAEGEN2-2489)
 509    - Slice Analysis - Avoid removal of data when insufficient samples are present (DCAEGEN2-2509)
 510
 511
 512 - Following new services are delivered this release
 513     - VES OpenAPI Manager
 514     - KPI MS (Analytics/RCA)
 515
 516 .. _honolulu_deliverable:
 517
 518 Deliverables
 519 ------------
 520
 521 Software Deliverables
 522
 523 .. csv-table::
 524    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
 525    :widths: auto
 526
 527    "dcaegen2/analytics/tca-gen2", "", "onap/org.onap.dcaegen2.analytics.tca-gen2.dcae-analytics-tca-web:1.2.1"
 528    "dcaegen2/collectors/datafile", "", "onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.5.5"
 529    "dcaegen2/collectors/hv-ves", "", "onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.6.0"
 530    "dcaegen2/collectors/restconf", "", "onap/org.onap.dcaegen2.collectors.restconfcollector:1.2.4"
 531    "dcaegen2/collectors/snmptrap", "", "onap/org.onap.dcaegen2.collectors.snmptrap:2.0.4"
 532    "dcaegen2/collectors/ves", "", "onap/org.onap.dcaegen2.collectors.ves.vescollector:1.8.0"
 533    "dcaegen2/deployments", "cm-container", "onap/org.onap.dcaegen2.deployments.cm-container:4.4.2"
 534    "dcaegen2/deployments", "consul-loader-container", "onap/org.onap.dcaegen2.deployments.consul-loader-container:1.1.0"
 535    "dcaegen2/deployments", "dcae-k8s-cleanup-container", "onap/org.onap.dcaegen2.deployments.dcae-k8s-cleanup-container:1.0.0"
 536    "dcaegen2/deployments", "healthcheck-container", "onap/org.onap.dcaegen2.deployments.healthcheck-container:2.1.0"
 537    "dcaegen2/deployments", "tls-init-container", "onap/org.onap.dcaegen2.deployments.tls-init-container:2.1.0"
 538    "dcaegen2/deployments", "dcae-services-policy-sync", "onap/org.onap.dcaegen2.deployments.dcae-services-policy-sync:1.0.0"
 539    "dcaegen2/platform", "mod/onboardingapi", "onap/org.onap.dcaegen2.platform.mod.onboardingapi:2.12.5"
 540    "dcaegen2/platform", "mod/distributorapi", "onap/org.onap.dcaegen2.platform.mod.distributorapi:1.1.0"
 541    "dcaegen2/platform", "mod/designtool", "onap/org.onap.dcaegen2.platform.mod.designtool-web:1.0.2"
 542    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-http:1.0.2"
 543    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-job:1.0.2"
 544    "dcaegen2/platform", "mod/designtool/mod-registry", "onap/org.onap.dcaegen2.platform.mod.mod-registry:1.0.0"
 545    "dcaegen2/platform", "mod/runtimeapi", "onap/org.onap.dcaegen2.platform.mod.runtime-web:1.2.3"
 546    "dcaegen2/platform", "adapter/acumos", "onap/org.onap.dcaegen2.platform.adapter.acumos:1.0.4"
 547    "dcaegen2/platform/blueprints", "", "onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:3.0.4"
 548    "dcaegen2/platform/configbinding", "", "onap/org.onap.dcaegen2.platform.configbinding:2.5.3"
 549    "dcaegen2/platform/deployment-handler", "", "onap/org.onap.dcaegen2.platform.deployment-handler:4.4.1"
 550    "dcaegen2/platform/inventory-api", "", "onap/org.onap.dcaegen2.platform.inventory-api:3.5.2"
 551    "dcaegen2/platform/policy-handler", "", "onap/org.onap.dcaegen2.platform.policy-handler:5.1.2"
 552    "dcaegen2/platform/servicechange-handler", "", "onap/org.onap.dcaegen2.platform.servicechange-handler:1.4.0"
 553    "dcaegen2/platform/ves-openapi-manager", "", "onap/org.onap.dcaegen2.platform.ves-openapi-manager:1.0.1"
 554    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakefeeder:1.1.0"
 555    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakeadminui:1.1.0"
 556    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalake.exposure.service:1.1.0"
 557    "dcaegen2/services", "components/pm-subscription-handler", "onap/org.onap.dcaegen2.services.pmsh:1.1.2"
 558    "dcaegen2/services", "components/slice-analysis-ms", "onap/org.onap.dcaegen2.services.components.slice-analysis-ms:1.0.4"
 559    "dcaegen2/services", "components/bbs-event-processor", "onap/org.onap.dcaegen2.services.components.bbs-event-processor:2.0.1"
 560    "dcaegen2/services", "components/kpi-ms", "onap/org.onap.dcaegen2.services.components.kpi-ms:1.0.0"
 561    "dcaegen2/services/heartbeat", "", "onap/org.onap.dcaegen2.services.heartbeat:2.1.1"
 562    "dcaegen2/services/mapper", "", "onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.2.0"
 563    "dcaegen2/services/pm-mapper", "", "onap/org.onap.dcaegen2.services.pm-mapper:1.5.2"
 564    "dcaegen2/services/prh", "", "onap/org.onap.dcaegen2.services.prh.prh-app-server:1.5.6"
 565    "dcaegen2/services/son-handler", "", "onap/org.onap.dcaegen2.services.son-handler:2.1.3"
 566    "dcaegen2/platform", "mod/bpgenerator", "Blueprint Generator 1.7.3 (jar)"
 567    "dcaegen2/services/sdk", "", "DCAE SDK 1.7.0 (jar)"
 568    "ccsdk/dashboard", "", "onap/org.onap.ccsdk.dashboard.ccsdk-app-os:1.4.0"
 569
 570
 571 Known Limitations, Issues and Workarounds
 572 -----------------------------------------
 573
 574 The new, Helm based installation mechanism for collectors doesn't support yet certain features available with the traditional Cloudify orchestration based mechanisms:
 575    - Obtaining X.509 certificates from external CMP v2 server for secure xNF connections
 576    - Exposing the Collector port in Dual Stack IPv4/IPv6 networks.
 577
 578 Such features are available, when the collectors are installed using the Cloudify mechanisms.
 579 Refer to collector installation page for more details:
 580
 581 .. toctree::
 582    :maxdepth: 1
 583
 584    ./services/ves-http/installation.rst
 585    ./services/ves-hv/installation.rst
 586
 587
 588 *Known Vulnerabilities*
 589
 590 None
 591
 592 *Workarounds*
 593
 594 Documented under corresponding jira if applicable.
 595
 596 Security Notes
 597 --------------
 598
 599 *Fixed Security Issues*
 600
 601     Documented on earlier section
 602
 603 *Known Security Issues*
 604
 605     None
 606
 607 *Known Vulnerabilities in Used Modules*
 608
 609     None
 610
 611 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_.
 612
 613 Test Results
 614 ------------
 615
 616  - `DCAE R8 Pairwise Test <https://wiki.onap.org/display/DW/DCAE+Pair+Wise+Testing+for+Honolulu+Release>`_
 617  - `DCAE R8 Functional Test <https://wiki.onap.org/display/DW/DCAE+R8+Testplan>`_
 618
 619
 620 References
 621 ----------
 622
 623 For more information on the ONAP Honolulu release, please see:
 624
 625 #. `ONAP Home Page`_
 626 #. `ONAP Documentation`_
 627 #. `ONAP Release Downloads`_
 628 #. `ONAP Wiki Page`_
 629
 630
 631 .. _`ONAP Home Page`: https://www.onap.org
 632 .. _`ONAP Wiki Page`: https://wiki.onap.org
 633 .. _`ONAP Documentation`: https://docs.onap.org
 634 .. _`ONAP Release Downloads`: https://git.onap.org
 635
 636 Quick Links:
 637
 638         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 639         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 640
 641
 642 ..      ===================================
 643 ..      * * *    GUILIN  MAINTENANCE  * * *
 644 ..      ===================================
 645
 646
 647 Version: 7.0.1
 648 ==============
 649
 650 Abstract
 651 --------
 652
 653 This document provides the release notes for the Guilin Maintenance release
 654
 655
 656 Summary
 657 -------
 658
 659 This maintenance release is primarily to resolve bugs identified during Guilin release testing.
 660
 661
 662 Release Data
 663 ------------
 664
 665 +--------------------------------------+--------------------------------------+
 666 | **Project**                          | DCAE                                 |
 667 |                                      |                                      |
 668 +--------------------------------------+--------------------------------------+
 669 | **Docker images**                    | onap/org.onap.dcaegen2.collectors    |
 670 |                                      |   .hv-ves.hv-collector-main:1.5.1    |
 671 +--------------------------------------+--------------------------------------+
 672 | **Release designation**              | Guilin Maintenance Release           |
 673 |                                      |                                      |
 674 +--------------------------------------+--------------------------------------+
 675 | **Release date**                     | 2021/04/19                           |
 676 |                                      |                                      |
 677 +--------------------------------------+--------------------------------------+
 678
 679 New features
 680 ------------
 681
 682 None
 683
 684 **Bug fixes**
 685
 686 - `DCAEGEN2-2516 <https://jira.onap.org/browse/DCAEGEN2-2516>`_ HV-VES Pod recovery when config-fetch fails
 687 - `OOM-2641 <https://jira.onap.org/browse/OOM-2641>`_ Fix DCAEMOD paths based on Guilin ingress template
 688
 689 **Known Issues**
 690
 691 Same as Guilin Release
 692
 693
 694 ..      ========================
 695 ..      * * *    GUILIN    * * *
 696 ..      ========================
 697
 698
 699 Version: 7.0.0
 700 ==============
 701
 702
 703 Abstract
 704 --------
 705
 706 This document provides the release notes for Guilin release.
 707
 708 Summary
 709 -------
 710
 711 Following DCAE components are available with default ONAP/DCAE installation.
 712
 713     - Platform components
 714
 715         - Cloudify Manager (helm chart)
 716         - Bootstrap container (helm chart)
 717         - Configuration Binding Service (helm chart)
 718         - Deployment Handler (helm chart)
 719         - Policy Handler (helm chart
 720         - Service Change Handler (helm chart)
 721         - Inventory API (helm chart)
 722         - Dashboard (helm chart)
 723
 724     - Service components
 725
 726         - VES Collector
 727         - HV-VES Collector
 728         - PNF-Registration Handler
 729         - Docker based Threshold Crossing Analytics (TCA-Gen2)
 730         - Holmes Rule Management *
 731         - Holmes Engine Management *
 732
 733     - Additional resources that DCAE utilizes deployed using ONAP common charts:
 734
 735         - Postgres Database
 736         - Mongo Database
 737         - Redis Cluster Database
 738         - Consul Cluster
 739
 740 Below service components (mS) are available to be deployed on-demand.
 741
 742         - SNMPTrap Collector
 743         - RESTConf Collector
 744         - DataFile Collector
 745         - PM-Mapper
 746         - BBS-EventProcessor
 747         - VES Mapper
 748         - Heartbeat mS
 749         - SON-Handler
 750         - PM-Subscription Handler
 751         - DataLake Handler (Admin and Feeder)
 752         - Slice Analysis
 753         - DataLake Extraction Service
 754
 755     Notes:
 756
 757         \*  These components are delivered by the Holmes project.
 758
 759
 760
 761 Under OOM (Kubernetes) all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster. DCAE platform components are deployed using Helm charts. DCAE service components are deployed using Cloudify blueprints. DCAE provides a Cloudify Manager plugin (k8splugin) that is capable of expanding a Cloudify blueprint node specification for a service component to a full Kubernetes specification, with additional enhancements such as replica scaling, sidecar for logging to ONAP ELK stack, registering services to MSB, etc.
 762
 763
 764 Release Data
 765 ------------
 766
 767 +--------------------------------------+--------------------------------------------------------+
 768 | **DCAE Project**                     |                                                        |
 769 |                                      |                                                        |
 770 +--------------------------------------+--------------------------------------------------------+
 771 | **Docker images**                    | Refer :any:`Deliverable <guilin_deliverable>`          |
 772 |                                      |                                                        |
 773 +--------------------------------------+--------------------------------------------------------+
 774 | **Release designation**              | 7.0.0 Guilin                                           |
 775 |                                      |                                                        |
 776 +--------------------------------------+--------------------------------------------------------+
 777 | **Release date**                     | 2020-11-19                                             |
 778 |                                      |                                                        |
 779 +--------------------------------------+--------------------------------------------------------+
 780
 781
 782 New features
 783 ------------
 784
 785 - DCAE Enhancements
 786
 787     - Cloudify Container upgraded with new base image; plugins load optimized (DCAEGEN2-2236, DCAEGEN2-2207, DCAEGEN2-2262)
 788     - Bootstrap container optimization  (DCAEGEN2-1791)
 789     - MOD/Runtime – Enable configuration for dynamic topic support (DCAEGEN2-1996)
 790     - MOD/OnboardingAPI - Support for offline install (DCAEGEN2-2221)
 791     - DCAE Dashboard UI Optimization  and bugfixes (DCAEGEN2-2223, DCAEGEN2-2364,DCAEGEN2-1638,DCAEGEN2-2298, DCAEGEN2-1857)
 792     - Blueprint generator tool and K8Splugin enhancement to support External Certificate (DCAEGEN2-2250)
 793     - K8S v1.17 support through DCAE Cloudify K8S plugins (DCAEGEN2-2309)
 794     - Python 3.8 support enabled for several DCAE components - Heartbeat mS, PMSH mS, MOD/DistriubtorAPI mS, MOD/OnboardingAPI mS, Policy Library (DCAEGEN2-2292)
 795     - Java 11 upgrade complete for following modules - RESTConf, PM-Mapper, DFC, VES-Mapper, SON-handler, TCA-gen2, DL-Feeder, InventoryAPI, ServiceChangeHandler, MOD/RuntimeAPI, MOD/Bp-gen (DCAEGEN2-2223)
 796     - Hardcoded password removed from OOM charts - Cloudify, Bootstrap, DeploymentHandler, Dashboard; now managed dynamically through K8S secret (DCAEGEN2-1972, DCAEGEN2-1975)
 797     - Best practice compliance
 798          - STDOUT log compliance for DCAE Containers (DCAEGEN2-2324)
 799          - No more than one main process (DCAEGEN2-2327/REQ-365)
 800          - Container must crash when failure is noted (DCAEGEN2-2326/REQ-366)
 801          - All containers must run as non-root (REQ-362)
 802          - Code coverage >55% (DCAEGEN2-2333)
 803     - All Vulnerability identified by SECCOM has been resolved (DCAEGEN2-2242)
 804
 805
 806 - Following new services are delivered this release
 807
 808     - Event Processors
 809         - DataLake Extraction Service
 810
 811     - Analytics/RCA
 812         - Slice Analysis MS
 813
 814 .. _guilin_deliverable:
 815
 816 Deliverables
 817 ------------
 818
 819 Software Deliverables
 820
 821 .. csv-table::
 822    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
 823    :widths: auto
 824
 825    "dcaegen2/analytics/tca-gen2", "", "onap/org.onap.dcaegen2.analytics.tca-gen2.dcae-analytics-tca-web:1.2.1"
 826    "dcaegen2/collectors/datafile", "", "onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.4.3"
 827    "dcaegen2/collectors/hv-ves", "", "onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.5.0"
 828    "dcaegen2/collectors/restconf", "", "onap/org.onap.dcaegen2.collectors.restconfcollector:1.2.2"
 829    "dcaegen2/collectors/snmptrap", "", "onap/org.onap.dcaegen2.collectors.snmptrap:2.0.3"
 830    "dcaegen2/collectors/ves", "", "onap/org.onap.dcaegen2.collectors.ves.vescollector:1.7.9"
 831    "dcaegen2/deployments", "cm-container", "onap/org.onap.dcaegen2.deployments.cm-container:3.3.4"
 832    "dcaegen2/deployments", "consul-loader-container", "onap/org.onap.dcaegen2.deployments.consul-loader-container:1.0.0"
 833    "dcaegen2/deployments", "dcae-k8s-cleanup-container", "onap/org.onap.dcaegen2.deployments.dcae-k8s-cleanup-container:1.0.0"
 834    "dcaegen2/deployments", "healthcheck-container", "onap/org.onap.dcaegen2.deployments.healthcheck-container:2.1.0"
 835    "dcaegen2/deployments", "multisite-init-container", "onap/org.onap.dcaegen2.deployments.multisite-init-container:1.0.0"
 836    "dcaegen2/deployments", "tls-init-container", "onap/org.onap.dcaegen2.deployments.tls-init-container:2.1.0"
 837    "dcaegen2/platform", "mod/onboardingapi", "onap/org.onap.dcaegen2.platform.mod.onboardingapi:2.12.3"
 838    "dcaegen2/platform", "mod/distributorapi", "onap/org.onap.dcaegen2.platform.mod.distributorapi:1.1.0"
 839    "dcaegen2/platform", "mod/designtool", "onap/org.onap.dcaegen2.platform.mod.designtool-web:1.0.2"
 840    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-http:1.0.2"
 841    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-job:1.0.2"
 842    "dcaegen2/platform", "mod/designtool/mod-registry", "onap/org.onap.dcaegen2.platform.mod.mod-registry:1.0.0"
 843    "dcaegen2/platform", "mod/runtimeapi", "onap/org.onap.dcaegen2.platform.mod.runtime-web:1.1.1"
 844    "dcaegen2/platform", "adapter/acumos", "onap/org.onap.dcaegen2.platform.adapter.acumos:1.0.3"
 845    "dcaegen2/platform/blueprints", "", "onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:2.1.8"
 846    "dcaegen2/platform/configbinding", "", "onap/org.onap.dcaegen2.platform.configbinding:2.5.3"
 847    "dcaegen2/platform/deployment-handler", "", "onap/org.onap.dcaegen2.platform.deployment-handler:4.4.1"
 848    "dcaegen2/platform/inventory-api", "", "onap/org.onap.dcaegen2.platform.inventory-api:3.5.1"
 849    "dcaegen2/platform/policy-handler", "", "onap/org.onap.dcaegen2.platform.policy-handler:5.1.0"
 850    "dcaegen2/platform/servicechange-handler", "", "onap/org.onap.dcaegen2.platform.servicechange-handler:1.4.0"
 851    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakefeeder:1.1.0"
 852    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakeadminui:1.1.0"
 853    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalake.exposure.service:1.1.0"
 854    "dcaegen2/services", "components/pm-subscription-handler", "onap/org.onap.dcaegen2.services.pmsh:1.1.2"
 855    "dcaegen2/services", "components/slice-analysis-ms", "onap/org.onap.dcaegen2.services.components.slice-analysis-ms:1.0.1"
 856    "dcaegen2/services", "components/bbs-event-processor", "onap/org.onap.dcaegen2.services.components.bbs-event-processor:2.0.1"
 857    "dcaegen2/services/heartbeat", "", "onap/org.onap.dcaegen2.services.heartbeat:2.1.1"
 858    "dcaegen2/services/mapper", "", "onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.1.0"
 859    "dcaegen2/services/pm-mapper", "", "onap/org.onap.dcaegen2.services.pm-mapper:1.4.1"
 860    "dcaegen2/services/prh", "", "onap/org.onap.dcaegen2.services.prh.prh-app-server:1.5.4"
 861    "dcaegen2/services/son-handler", "", "onap/org.onap.dcaegen2.services.son-handler:2.1.2"
 862    "dcaegen2/platform", "mod/bpgenerator", "Blueprint Generator 1.5.2 (jar)"
 863    "dcaegen2/services/sdk", "", "DCAE SDK 1.4.3 (jar)"
 864    "ccsdk/dashboard", "", "onap/org.onap.ccsdk.dashboard.ccsdk-app-os:1.4.0"
 865
 866
 867 Known Limitations, Issues and Workarounds
 868 -----------------------------------------
 869
 870     * BPGenerator yaml Fixes are different for yaml file and string (DCAEGEN2-2489)
 871     * Slice Analysis - Avoid removal of data when insufficient samples are present (DCAEGEN2-2509)
 872     * HV-VES - Pod recovery when config-fetch fails (DCAEGEN2-2516)
 873
 874
 875 *System Limitations*
 876
 877 None
 878
 879 *Known Vulnerabilities*
 880
 881 None
 882
 883 *Workarounds*
 884
 885 Documented under corresponding jira if applicable.
 886
 887 Security Notes
 888 --------------
 889
 890 *Fixed Security Issues*
 891     Listed above
 892
 893 *Known Security Issues*
 894
 895         None
 896
 897
 898 *Known Vulnerabilities in Used Modules*
 899
 900         None
 901
 902 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_.
 903
 904 Test Results
 905 ------------
 906
 907  - `DCAE R7 Pairwise Test <https://wiki.onap.org/display/DW/DCAE+Pair+Wise+Testing+for+Guilin+Release>`_
 908  - `DCAE MOD R7 Test <https://wiki.onap.org/display/DW/DCAE+R7+Testplan>`_
 909
 910
 911 References
 912 ----------
 913
 914 For more information on the ONAP Guilin release, please see:
 915
 916 #. `ONAP Home Page`_
 917 #. `ONAP Documentation`_
 918 #. `ONAP Release Downloads`_
 919 #. `ONAP Wiki Page`_
 920
 921
 922 .. _`ONAP Home Page`: https://www.onap.org
 923 .. _`ONAP Wiki Page`: https://wiki.onap.org
 924 .. _`ONAP Documentation`: https://docs.onap.org
 925 .. _`ONAP Release Downloads`: https://git.onap.org
 926
 927 Quick Links:
 928
 929         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 930         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 931
 932
 933
 934
 935 ..      ======================================
 936 ..      * * *    EL-ALTO  MAINTENANCE  * * *
 937 ..      ======================================
 938
 939
 940 Version: 5.0.2
 941 ==============
 942
 943 Abstract
 944 --------
 945
 946 This document provides the release notes for the El-Alto Maintenance release
 947
 948
 949 Summary
 950 -------
 951
 952 This maintenance release is primarily to update expired certificates
 953 from original El-Alto released TLS-init container.
 954
 955 This patch is not required for Frankfurt release (and beyond) as certificates are dynamically
 956 retrieved from AAF at deployment time for all DCAE components.
 957
 958 Release Data
 959 ------------
 960
 961 +--------------------------------------+--------------------------------------+
 962 | **Project**                          | DCAE                                 |
 963 |                                      |                                      |
 964 +--------------------------------------+--------------------------------------+
 965 | **Docker images**                    | onap/org.onap.dcaegen2.deployments   |
 966 |                                      |   .tls-init-container:1.0.4          |
 967 +--------------------------------------+--------------------------------------+
 968 | **Release designation**              | El-Alto  Maintenance Release         |
 969 |                                      |                                      |
 970 +--------------------------------------+--------------------------------------+
 971 | **Release date**                     | 2020/08/24                           |
 972 |                                      |                                      |
 973 +--------------------------------------+--------------------------------------+
 974
 975 New features
 976 ------------
 977
 978 None
 979
 980 **Bug fixes**
 981
 982 - `DCAEGEN2-2206 <https://jira.onap.org/browse/DCAEGEN2-2206>`_ DCAE TLS Container : Address certificate expiration
 983
 984 **Known Issues**
 985 Same as El-Alto Release
 986
 987
 988
 989 ..      ======================================
 990 ..      * * *    FRANKFURT  MAINTENANCE  * * *
 991 ..      ======================================
 992
 993
 994 Version: 6.0.1
 995 ==============
 996
 997 Abstract
 998 --------
 999
1000 This document provides the release notes for the Frankfurt Maintenance release
1001
1002
1003 Summary
1004 -------
1005
1006 The focus of this release is to correct issues found on Frankfurt release.
1007
1008 Release Data
1009 ------------
1010
1011 +--------------------------------------+--------------------------------------+
1012 | **Project**                          | DCAE                                 |
1013 |                                      |                                      |
1014 +--------------------------------------+--------------------------------------+
1015 | **Docker images**                    | onap/org.onap.dcaegen2.services.     |
1016 |                                      |   son-handler:2.0.4                  |
1017 +--------------------------------------+--------------------------------------+
1018 | **Release designation**              | Frankfurt  Maintenance Release 1     |
1019 |                                      |                                      |
1020 +--------------------------------------+--------------------------------------+
1021 | **Release date**                     | 2020/08/17                           |
1022 |                                      |                                      |
1023 +--------------------------------------+--------------------------------------+
1024
1025 New features
1026 ------------
1027
1028 None
1029
1030 **Bug fixes**
1031
1032 - `DCAEGEN2-2249 <https://jira.onap.org/browse/DCAEGEN2-2249>`_ SON-Handler: Fix networkId issue while making call to oof
1033 - `DCAEGEN2-2216 <https://jira.onap.org/browse/DCAEGEN2-2216>`_ SON-Handler: Change Policy notification  to align with policy component updates
1034
1035 **Known Issues**
1036
1037 Same as Frankfurt Release
1038
1039
1040
1041
1042 ..      ===========================
1043 ..      * * *    FRANKFURT    * * *
1044 ..      ===========================
1045
1046
1047 Version: 6.0.0
1048 ==============
1049
1050
1051 Abstract
1052 --------
1053
1054 This document provides the release notes for the Frankfurt release.
1055
1056 Summary
1057 -------
1058
1059 Following DCAE components are available with default ONAP/DCAE installation.
1060
1061     - Platform components
1062
1063         - Cloudify Manager (helm chart)
1064         - Bootstrap container (helm chart)
1065         - Configuration Binding Service (helm chart)
1066         - Deployment Handler (helm chart)
1067         - Policy Handler (helm chart
1068         - Service Change Handler (helm chart)
1069         - Inventory API (helm chart)
1070         - Dashboard (helm chart)
1071
1072     - Service components
1073
1074         - VES Collector
1075         - Threshold Crossing Analytics (TCA/CDAP)
1076         - HV-VES Collector
1077         - PNF-Registration Handler
1078         - Docker based Threshold Crossing Analytics (TCA-Gen2)
1079         - Holmes Rule Management *
1080         - Holmes Engine Management *
1081
1082     - Additional resources that DCAE utilizes deployed using ONAP common charts:
1083
1084         - Postgres Database
1085         - Mongo Database
1086         - Redis Cluster Database
1087         - Consul Cluster
1088
1089 Below service components (mS) are available to be deployed on-demand.
1090
1091         - SNMPTrap Collector
1092         - RESTConf Collector
1093         - DataFile Collector
1094         - PM-Mapper
1095         - BBS-EventProcessor
1096         - VES Mapper
1097         - Heartbeat mS
1098         - SON-Handler
1099         - PM-Subscription Handler
1100
1101     Notes:
1102
1103         \*  These components are delivered by the Holmes project.
1104
1105
1106
1107 Under OOM (Kubernetes) deployment all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster. DCAE platform components are deployed using Helm charts. DCAE service components are deployed using Cloudify blueprints. DCAE provides a Cloudify Manager plugin (k8splugin) that is capable of expanding a Cloudify blueprint node specification for a service component to a full Kubernetes specification, with additional enhancements such as replica scaling, sidecar for logging to ONAP ELK stack, registering services to MSB, etc.
1108
1109
1110 Release Data
1111 ------------
1112
1113 +--------------------------------------+--------------------------------------------------------+
1114 | **DCAE Project**                     |                                                        |
1115 |                                      |                                                        |
1116 +--------------------------------------+--------------------------------------------------------+
1117 | **Docker images**                    |Refer :any:`Deliverable <frankfurt_deliverable>`        |
1118 |                                      |                                                        |
1119 +--------------------------------------+--------------------------------------------------------+
1120 | **Release designation**              | 6.0.0 frankfurt                                        |
1121 |                                      |                                                        |
1122 +--------------------------------------+--------------------------------------------------------+
1123 | **Release date**                     | 2020-06-04                                             |
1124 |                                      |                                                        |
1125 +--------------------------------------+--------------------------------------------------------+
1126
1127
1128 New features
1129 ------------
1130
1131 - DCAE Platform Enhancement
1132
1133     - Introduction of Microservice and Onboarding Design (MOD) platform
1134     - Policy Notification support for DCAE components
1135     - Dynamic AAF certificate creation during component instantiation
1136     - Helm chart optimization to control each platform component separate
1137     - Dashboard Optimization
1138     - Blueprint generator tool to simplify deployment artifact creation
1139
1140
1141 - Following new services are delivered this release
1142
1143     - Event Processors
1144
1145         - PM Subscription Handler
1146         - DataLake Handlers
1147     - Analytics/RCA
1148
1149         - TCA-GEN2
1150
1151         - Acumos Adapter (PoC)
1152
1153 .. _frankfurt_deliverable:
1154
1155 Deliverables
1156 ------------
1157
1158 Software Deliverables
1159
1160 .. csv-table::
1161    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
1162    :widths: auto
1163
1164    "dcaegen2/analytics/tca-gen2", "", "onap/org.onap.dcaegen2.analytics.tca-gen2.dcae-analytics-tca-web:1.0.1"
1165    "dcaegen2/collectors/datafile", "", "onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.3.0"
1166    "dcaegen2/collectors/hv-ves", "", "onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.4.0"
1167    "dcaegen2/collectors/restconf", "", "onap/org.onap.dcaegen2.collectors.restconfcollector:1.1.1"
1168    "dcaegen2/collectors/snmptrap", "", "onap/org.onap.dcaegen2.collectors.snmptrap:2.0.3"
1169    "dcaegen2/collectors/ves", "", "onap/org.onap.dcaegen2.collectors.ves.vescollector:1.5.4"
1170    "dcaegen2/deployments", "cm-container", "onap/org.onap.dcaegen2.deployments.cm-container:2.1.0"
1171    "dcaegen2/deployments", "consul-loader-container", "onap/org.onap.dcaegen2.deployments.consul-loader-container:1.0.0"
1172    "dcaegen2/deployments", "dcae-k8s-cleanup-container", "onap/org.onap.dcaegen2.deployments.dcae-k8s-cleanup-container:1.0.0"
1173    "dcaegen2/deployments", "healthcheck-container", "onap/org.onap.dcaegen2.deployments.healthcheck-container:1.3.1"
1174    "dcaegen2/deployments", "multisite-init-container", "onap/org.onap.dcaegen2.deployments.multisite-init-container:1.0.0"
1175    "dcaegen2/deployments", "redis-cluster-container", "onap/org.onap.dcaegen2.deployments.redis-cluster-container:1.0.0"
1176    "dcaegen2/deployments", "tca-cdap-container", "onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.2.2"
1177    "dcaegen2/deployments", "tls-init-container", "onap/org.onap.dcaegen2.deployments.tls-init-container:2.1.0"
1178    "dcaegen2/platform", "mod/onboardingapi", "onap/org.onap.dcaegen2.platform.mod.onboardingapi:2.12.1"
1179    "dcaegen2/platform", "mod/distributorapi", "onap/org.onap.dcaegen2.platform.mod.distributorapi:1.0.1"
1180    "dcaegen2/platform", "mod/designtool", "onap/org.onap.dcaegen2.platform.mod.designtool-web:1.0.2"
1181    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-http:1.0.1"
1182    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-job:1.0.1"
1183    "dcaegen2/platform", "mod/designtool/mod-registry", "onap/org.onap.dcaegen2.platform.mod.mod-registry:1.0.0"
1184    "dcaegen2/platform", "mod/runtimeapi", "onap/org.onap.dcaegen2.platform.mod.runtime-web:1.0.3"
1185    "dcaegen2/platform/blueprints", "", "onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.12.6"
1186    "dcaegen2/platform/configbinding", "", "onap/org.onap.dcaegen2.platform.configbinding:2.5.2"
1187    "dcaegen2/platform/deployment-handler", "", "onap/org.onap.dcaegen2.platform.deployment-handler:4.3.0"
1188    "dcaegen2/platform/inventory-api", "", "onap/org.onap.dcaegen2.platform.inventory-api:3.4.1"
1189    "dcaegen2/platform/policy-handler", "", "onap/org.onap.dcaegen2.platform.policy-handler:5.1.0"
1190    "dcaegen2/platform/servicechange-handler", "", "onap/org.onap.dcaegen2.platform.servicechange-handler:1.3.2"
1191    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakefeeder:1.0.2"
1192    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakeadminui:1.0.2"
1193    "dcaegen2/services", "components/pm-subscription-handler", "onap/org.onap.dcaegen2.services.pmsh:1.0.3"
1194    "dcaegen2/services", "components/bbs-event-processor", "onap/org.onap.dcaegen2.services.components.bbs-event-processor:2.0.0"
1195    "dcaegen2/services/heartbeat", "", "onap/org.onap.dcaegen2.services.heartbeat:2.1.0"
1196    "dcaegen2/services/mapper", "", "onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.0.1"
1197    "dcaegen2/services/pm-mapper", "", "onap/org.onap.dcaegen2.services.pm-mapper:1.3.1"
1198    "dcaegen2/services/prh", "", "onap/org.onap.dcaegen2.services.prh.prh-app-server:1.5.2"
1199    "dcaegen2/services/son-handler", "", "onap/org.onap.dcaegen2.services.son-handler:2.0.2"
1200    "dcaegen2/platform", "adapter/acumos", "onap/org.onap.dcaegen2.platform.adapter.acumos:1.0.2"
1201    "dcaegen2/platform", "mod/bpgenerator", "Blueprint Generator 1.3.1 (jar)"
1202    "dcaegen2/services/sdk", "", "DCAE SDK 1.3.5 (jar)"
1203    "ccsdk/dashboard", "", "onap/org.onap.ccsdk.dashboard.ccsdk-app-os:1.3.2"
1204
1205
1206 Known Limitations, Issues and Workarounds
1207 -----------------------------------------
1208
1209     * Blueprint generator escape char issue (DCAEGEN2-2140)
1210     * TCAgen2 Policy configuration support (DCAEGEN2-2198)
1211     * TCA/CDAP config refresh causes duplicate events (DCAEGEN2-2241)
1212
1213
1214
1215 *System Limitations*
1216
1217 None
1218
1219 *Known Vulnerabilities*
1220
1221 None
1222
1223 *Workarounds*
1224
1225 Documented under corresponding jira if applicable.
1226
1227 Security Notes
1228 --------------
1229
1230 *Fixed Security Issues*
1231
1232     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
1233     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
1234     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
1235     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
1236     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
1237
1238
1239 *Known Security Issues*
1240
1241         None
1242
1243
1244 *Known Vulnerabilities in Used Modules*
1245
1246         None
1247
1248 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_.
1249
1250 Test Results
1251 ------------
1252
1253  - `DCAE R6 Pairwise Test <https://wiki.onap.org/display/DW/DCAE+Pair+Wise+Testing+for+Frankfurt+Release>`_
1254  - `DCAE MOD R6 Test <https://wiki.onap.org/display/DW/DCAE+MOD+Test+Plan>`_
1255
1256
1257 References
1258 ----------
1259
1260 For more information on the ONAP Frankfurt release, please see:
1261
1262 #. `ONAP Home Page`_
1263 #. `ONAP Documentation`_
1264 #. `ONAP Release Downloads`_
1265 #. `ONAP Wiki Page`_
1266
1267
1268 .. _`ONAP Home Page`: https://www.onap.org
1269 .. _`ONAP Wiki Page`: https://wiki.onap.org
1270 .. _`ONAP Documentation`: https://docs.onap.org
1271 .. _`ONAP Release Downloads`: https://git.onap.org
1272
1273 Quick Links:
1274
1275         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
1276         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
1277
1278
1279 ..      =========================
1280 ..      * * *    EL-ALTO    * * *
1281 ..      =========================
1282
1283
1284 Version: 5.0.1
1285 ==============
1286
1287 The offical El-Alto release (rolls up all 5.0.0 early drop deliverables) focused on technical debts and SECCOM priority work-items.
1288
1289 Following is summary of updates done for DCAEGEN2
1290
1291 **Security**
1292
1293 Following platform components were enabled for HTTPS
1294     - ConfigBindingService (CBS)
1295       -   CBS is used by all DCAE MS to fetch DCAE MS configuration from Consul. To mitigate impact for DCAE MS, CBS deployment through OOM/Helm was modified to support CBS on both HTTP and HTTPS. `Design for CBS TLS migration <https://wiki.onap.org/display/DW/TLS+support+for+CBS+-+Migration+Plan>`_
1296     - Cloudify Manager
1297     - InventoryAPI
1298     - Non-root container process (ConfigBindingService, InventoryAPI, ServiceChangeHandler, HV-VES, PRH, Son-handler)
1299
1300 All components interfacing with platform components were modified to support TLS interface
1301
1302 **Miscellaneous**
1303     - DCAE Dashboard deployment migration from cloudify blueprint to OOM/Chart
1304     - Dynamic Topic support via Dmaap plugin integration for DataFileCollector MS
1305     - Dynamic Topic support via Dmaap plugin integration for PM-Mapper service
1306     - CBS client libraries updated to remove consul service lookup
1307     - Image Optimization (ConfigBindingService, InventoryAPI, ServiceChangeHandler, HV-VES, PRH, Son-handler)
1308
1309
1310
1311 With this release, all DCAE platform components has been migrated to helm charts. Following is complete list of DCAE components available part of default ONAP/DCAE installation.
1312     - Platform components
1313         - Cloudify Manager (helm chart)
1314         - Bootstrap container (helm chart)
1315         - Configuration Binding Service (helm chart)
1316         - Deployment Handler (helm chart)
1317         - Policy Handler (helm chart
1318         - Service Change Handler (helm chart)
1319         - Inventory API (helm chart)
1320         - Dashboard (helm charts)
1321     - Service components
1322         - VES Collector
1323         - SNMP Collector
1324         - Threshold Crossing Analytics
1325         - HV-VES Collector
1326         - PNF-Registration Handler
1327         - Holmes Rule Management *
1328         - Holmes Engine Management *
1329     - Additional resources that DCAE utilizes:
1330         - Postgres Database
1331         - Redis Cluster Database
1332         - Consul Cluster *
1333
1334     Notes:
1335         \*  These components are delivered by external ONAP project.
1336
1337 DCAE also includes below MS which can be deployed on-demand (via Dashboard or Cloudify CLI or CLAMP)
1338
1339     - Collectors
1340         - RESTConf collector
1341         - DataFile collector
1342     - Event Processors
1343         - VES Mapper
1344         - 3gpp PM-Mapper
1345         - BBS Event processor
1346     - Analytics/RCA
1347         - SON-Handler
1348         - Missing Heartbeat Ms
1349
1350 - All DCAE components are designed to support platform maturity requirements.
1351
1352
1353 **Source Code**
1354
1355 Source code of DCAE components are released under the following repositories on gerrit.onap.org; there is no new component introduced for El-Alto Early-drop.
1356     - dcaegen2
1357     - dcaegen2.analytics.tca
1358     - dcaegen2.collectors.snmptrap
1359     - dcaegen2.collectors.ves
1360     - dcaegen2.collectors.hv-ves
1361     - dcaegen2.collectors.datafile
1362     - dcaegen2.collectors.restconf
1363     - dcaegen2.deployments
1364     - dcaegen2.platform.blueprints
1365     - dcaegen2.platform.cli
1366     - dcaegen2.platform.configbinding
1367     - dcaegen2.platform.deployment-handler
1368     - dcaegen2.platform.inventory-api
1369     - dcaegen2.platform.plugins
1370     - dcaegen2.platform.policy-handler
1371     - dcaegen2.platform.servicechange-handler
1372     - dcaegen2.services.heartbeat
1373     - dcaegen2.services.mapper
1374     - dcaegen2.services.pm-mapper
1375     - dcaegen2.services.prh
1376     - dcaegen2.services.son-handler
1377     - dcaegen2.services
1378     - dcaegen2.services.sdk
1379     - dcaegen2.utils
1380     - ccsdk.platform.plugins
1381     - ccsdk.dashboard
1382
1383 **Bug Fixes**
1384     * k8splugin can generate deployment name > 63 chars (DCAEGEN2-1667)
1385     * CM container loading invalid Cloudify types file (DCAEGEN2-1685)
1386
1387
1388 **Known Issues**
1389     * Healthcheck/Readiness probe VES Collector when authentication is enabled (DCAEGEN2-1594)
1390
1391 **Security Notes**
1392
1393 *Fixed Security Issues*
1394     * Unsecured Swagger UI Interface in xdcae-datafile-collector. [`OJSI-28 <https://jira.onap.org/browse/OJSI-28>`_]
1395     * In default deployment DCAEGEN2 (xdcae-datafile-collector) exposes HTTP port 30223 outside of cluster. [`OJSI-109 <https://jira.onap.org/browse/OJSI-109>`_]
1396     * In default deployment DCAEGEN2 (xdcae-tca-analytics) exposes HTTP port 32010 outside of cluster. [`OJSI-161 <https://jira.onap.org/browse/OJSI-161>`_]
1397     * In default deployment DCAEGEN2 (dcae-datafile-collector) exposes HTTP port 30262 outside of cluster. [`OJSI-131 <https://jira.onap.org/browse/OJSI-131>`_]
1398     * CVE-2019-12126 - DCAE TCA exposes unprotected APIs/UIs on port 32010. [`OJSI-201 <https://jira.onap.org/browse/OJSI-201>`_]
1399
1400 *Known Security Issues*
1401     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
1402     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
1403     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
1404     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
1405     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
1406
1407 *Known Vulnerabilities in Used Modules*
1408
1409 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_.
1410
1411 Quick Links:
1412         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
1413
1414         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
1415
1416         - `Project Vulnerability Review Table for DCAE (El-Alto Maintenance) <https://wiki.onap.org/pages/viewpage.action?pageId=68540441>`_
1417
1418
1419 **Upgrade Notes**
1420
1421 The following components are upgraded from Dublin/R4 and El-Alto EarlyDrop deliverables.
1422     - K8S Bootstrap container:
1423        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.6.4
1424        - Description: K8s bootstrap container updated to interface with Cloudify using HTTPS; new k8s and Dmaap plugin version included; Dashboard deployment was removed.
1425     - Configuration Binding Service:
1426        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.5.2
1427        - Description: HTTPS support, Image optimization and non-root user
1428     - Inventory API
1429        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.4.0
1430        - Description: HTTPS support, container optmization and non-root user
1431     - DataFile Collector
1432        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.2.3
1433        - Description : Code optimization, bug fixes, dmaap plugin integration
1434     - SON Handler MS
1435        - Docker container tag: onap/org.onap.dcaegen2.services.son-handler:1.1.1
1436        - Description : Image optimization, bug fixes, CBS integration
1437     - VES Adapter/Mapper MS
1438        - Docker container tag: onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.0.1
1439        - Description : Image optimization & CBS periodic polling
1440     - PRH MS
1441        - Docker container tag: onap/org.onap.dcaegen2.services.prh.prh-app-server:1.3.1
1442        - Description : Code optimization, bug fixes and SDK alignment
1443     - HV-VES MS
1444        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.3.0
1445        - Description : Code optimization, bug fixes and SDK alignment
1446
1447 Version: 5.0.0
1448 ==============
1449
1450 El-Alto Early-drop focused on technical debts and SECCOM priority work-items.
1451
1452 Following is summary of updates done for DCAEGEN2
1453
1454 **Security**
1455
1456 Following platform components were enabled for HTTPS
1457     - ConfigBindingService (CBS)
1458       -   CBS is used by all DCAE MS to fetch DCAE MS configuration from Consul. To mitigate impact for DCAE MS, CBS deployment through OOM/Helm was modified to support CBS on both HTTP and HTTPS. `Design for CBS TLS migration <https://wiki.onap.org/display/DW/TLS+support+for+CBS+-+Migration+Plan>`_
1459     - Cloudify Manager
1460     - InventoryAPI
1461
1462 All components interfacing with platform components were modified to support TLS interface
1463
1464 **Miscellaneous**
1465     - DCAE Dashboard deployment migration from cloudify blueprint to OOM/Chart
1466     - Dynamic Topic support via Dmaap plugin integration for DataFileCollector MS
1467     - Dynamic Topic support via Dmaap plugin integration for PM-Mapper service
1468     - CBS client libraries updated to remove consul service lookup
1469
1470
1471
1472 **Bug Fixes**
1473     * k8splugin can generate deployment name > 63 chars (DCAEGEN2-1667)
1474     * CM container loading invalid Cloudify types file (DCAEGEN2-1685)
1475
1476
1477 **Known Issues**
1478     * Healthcheck/Readiness probe VES Collector when authentication is enabled (DCAEGEN2-1594)
1479
1480
1481 **Security Notes**
1482
1483 *Fixed Security Issues*
1484
1485 *Known Security Issues*
1486
1487     * Unsecured Swagger UI Interface in xdcae-datafile-collector. [`OJSI-28 <https://jira.onap.org/browse/OJSI-28>`_]
1488     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
1489     * In default deployment DCAEGEN2 (xdcae-datafile-collector) exposes HTTP port 30223 outside of cluster. [`OJSI-109 <https://jira.onap.org/browse/OJSI-109>`_]
1490     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
1491     * In default deployment DCAEGEN2 (dcae-datafile-collector) exposes HTTP port 30262 outside of cluster. [`OJSI-131 <https://jira.onap.org/browse/OJSI-131>`_]
1492     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
1493     * In default deployment DCAEGEN2 (xdcae-tca-analytics) exposes HTTP port 32010 outside of cluster. [`OJSI-161 <https://jira.onap.org/browse/OJSI-161>`_]
1494     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
1495     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
1496     * CVE-2019-12126 - DCAE TCA exposes unprotected APIs/UIs on port 32010. [`OJSI-201 <https://jira.onap.org/browse/OJSI-201>`_]
1497
1498 *Known Vulnerabilities in Used Modules*
1499
1500 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_.
1501
1502 Quick Links:
1503         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
1504
1505         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
1506
1507         - `Project Vulnerability Review Table for DCAE (El-Alto) <https://wiki.onap.org/pages/viewpage.action?pageId=68540441>`_
1508
1509
1510 **Upgrade Notes**
1511
1512 The following components are upgraded from Dublin/R4.
1513     - Cloudify Manager:
1514        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:2.0.2
1515        - Description: DCAE's Cloudify Manager container is based on Cloudify Manager Community Version 19.01.24, which is based on Cloudify Manager 4.5. The container was updated to support TLS.
1516     - K8S Bootstrap container:
1517        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.6.2
1518        - Description: K8s bootstrap container updated to interface with Cloudify using HTTPS; new k8s and Dmaap plugin version included; Dashboard deployment was removed.
1519     - Configuration Binding Service:
1520        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.5.1
1521        - Description: HTTPS support, Image optimization and non-root user
1522     - Deployment Handler
1523        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:4.2.0
1524        - Description: Update to node10, uninstall workflow updates
1525     - Service Change Handler
1526        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.3.2
1527        - Description: HTTPS inventoryAPI support, container optmization and non-root user
1528     - Inventory API
1529        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.4.0
1530        - Description: HTTPS support, container optmization and non-root user
1531     - DataFile Collector
1532        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.2.2
1533        - Description : Code optimization, bug fixes, dmaap plugin integration
1534     - 3gpp PM-Mapper
1535        - Docker container tag: onap/org.onap.dcaegen2.services.pm-mapper:1.1.3
1536        - Description: Code optimization, bug fixes, dmaap plugin integration
1537
1538
1539
1540 Version: 4.0.0
1541 ==============
1542
1543 :Release Date: 2019-06-06
1544
1545 **New Features**
1546
1547 DCAE R4 improves upon previous release with the following new features:
1548
1549 - DCAE Platform Enhancement
1550     - Multisite K8S cluster deployment support for DCAE services (via K8S plugin)
1551     - Support helm chart deployment in DCAE using new Helm cloudify plugin
1552     - DCAE Healthcheck enhancement to cover static and dynamic deployments
1553     - Dynamic AAF based topic provisioning support through Dmaap cloudify plugin
1554     - Dashboard Integration (UI for deployment/verification)
1555     - PolicyHandler Enhancement to support new Policy Lifecycle API’s
1556     - Blueprint generator tool to simplify deployment artifact creation
1557     - Cloudify Manager resiliency
1558
1559 - Following new services are delivered with Dublin
1560     - Collectors
1561         - RESTConf collector
1562     - Event Processors
1563         - VES Mapper
1564         - 3gpp PM-Mapper
1565         - BBS Event processor
1566     - Analytics/RCA
1567         - SON-Handler
1568         - Heartbeat MS
1569
1570 Most platform components has been migrated to helm charts. Following is complete list of DCAE components available part of default ONAP/dcae installation.
1571     - Platform components
1572         - Cloudify Manager (helm chart)
1573         - Bootstrap container (helm chart)
1574         - Configuration Binding Service (helm chart)
1575         - Deployment Handler (helm chart)
1576         - Policy Handler (helm chart
1577         - Service Change Handler (helm chart)
1578         - Inventory API (helm chart)
1579         - Dashboard (Cloudify Blueprint)
1580     - Service components
1581         - VES Collector
1582         - SNMP Collector
1583         - Threshold Crossing Analytics
1584         - HV-VES Collector
1585         - PNF-Registration Handler
1586         - Holmes Rule Management *
1587         - Holmes Engine Management *
1588     - Additional resources that DCAE utilizes:
1589         - Postgres Database
1590         - Redis Cluster Database
1591         - Consul Cluster *
1592
1593     Notes:
1594         \*  These components are delivered by the Holmes project.
1595
1596
1597 Under OOM (Kubernetes) deployment all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster. DCAE R3 includes enhancement to Cloudify Manager plugin (k8splugin) that is capable of expanding a Blueprint node specification written for Docker container to a full Kubernetes specification, with additional enhancements such as replica scaling, sidecar for logging to ONAP ELK stack, registering services to MSB, etc.
1598
1599 - All DCAE components are designed to support platform maturity requirements.
1600
1601
1602 **Source Code**
1603
1604 Source code of DCAE components are released under the following repositories on gerrit.onap.org:
1605     - dcaegen2
1606     - dcaegen2.analytics.tca
1607     - dcaegen2.collectors.snmptrap
1608     - dcaegen2.collectors.ves
1609     - dcaegen2.collectors.hv-ves
1610     - dcaegen2.collectors.datafile
1611     - dcaegen2.collectors.restconf
1612     - dcaegen2.deployments
1613     - dcaegen2.platform.blueprints
1614     - dcaegen2.platform.cli
1615     - dcaegen2.platform.configbinding
1616     - dcaegen2.platform.deployment-handler
1617     - dcaegen2.platform.inventory-api
1618     - dcaegen2.platform.plugins
1619     - dcaegen2.platform.policy-handler
1620     - dcaegen2.platform.servicechange-handler
1621     - dcaegen2.services.heartbeat
1622     - dcaegen2.services.mapper
1623     - dcaegen2.services.pm-mapper
1624     - dcaegen2.services.prh
1625     - dcaegen2.services.son-handler
1626     - dcaegen2.services
1627     - dcaegen2.services.sdk
1628     - dcaegen2.utils
1629     - ccsdk.platform.plugins
1630     - ccsdk.dashboard
1631
1632 **Bug Fixes**
1633
1634 **Known Issues**
1635     * Healthcheck/Readiness probe VES Collector when authentication is enabled (DCAEGEN2-1594)
1636
1637
1638 **Security Notes**
1639
1640 *Fixed Security Issues*
1641
1642 *Known Security Issues*
1643
1644     * Unsecured Swagger UI Interface in xdcae-datafile-collector. [`OJSI-28 <https://jira.onap.org/browse/OJSI-28>`_]
1645     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
1646     * In default deployment DCAEGEN2 (xdcae-datafile-collector) exposes HTTP port 30223 outside of cluster. [`OJSI-109 <https://jira.onap.org/browse/OJSI-109>`_]
1647     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
1648     * In default deployment DCAEGEN2 (dcae-datafile-collector) exposes HTTP port 30262 outside of cluster. [`OJSI-131 <https://jira.onap.org/browse/OJSI-131>`_]
1649     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
1650     * In default deployment DCAEGEN2 (xdcae-tca-analytics) exposes HTTP port 32010 outside of cluster. [`OJSI-161 <https://jira.onap.org/browse/OJSI-161>`_]
1651     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
1652     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
1653     * CVE-2019-12126 - DCAE TCA exposes unprotected APIs/UIs on port 32010. [`OJSI-201 <https://jira.onap.org/browse/OJSI-201>`_]
1654
1655 *Known Vulnerabilities in Used Modules*
1656
1657 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_.
1658
1659 Quick Links:
1660         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
1661
1662         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
1663
1664         - `Project Vulnerability Review Table for DCAE (Dublin) <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_
1665
1666
1667 **New component Notes**
1668 The following components are introduced in R4
1669
1670     - Dashboard
1671        - Docker container tag: onap/org.onap.ccsdk.dashboard.ccsdk-app-os:1.1.0
1672        - Description: Dashboard provides an UI interface for users/operation to deploy and manage service components in DCAE
1673     - Blueprint generator
1674        - Java artifact : /org/onap/dcaegen2/platform/cli/blueprint-generator/1.0.0/blueprint-generator-1.0.0.jar
1675        - Description: Tool to generate the deployment artifact (cloudify blueprints) based on component spec
1676     - RESTConf collector
1677        - Docker container tag: onap/org.onap.dcaegen2.collectors.restconfcollector:1.1.1
1678        - Description: Provides RESTConf interfaces to events from external domain controllers
1679     - VES/Universal Mapper
1680        - Docker container tag: onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.0.0
1681        - Description: Standardizes events recieved from SNMP and RESTConf collector into VES for further processing with DCAE analytics services
1682     - 3gpp PM-Mapper
1683        - Docker container tag: onap/org.onap.dcaegen2.services.pm-mapper:1.0.1
1684        - Description: Transforms 3gpp data feed recieved from DMAAP-DR into VES events
1685     - BBS Event processor
1686        - Docker container tag: onap/org.onap.dcaegen2.services.components.bbs-event-processor:1.0.0
1687        - Description: Handles PNF-Reregistration and CPE authentication events and generate CL events
1688     - SON-Handler
1689        - Docker container tag: onap/org.onap.dcaegen2.services.son-handler:1.0.3
1690        - Description: Supports PC-ANR optimization analysis and generating CL events output
1691     - Heartbeat MS
1692        - Docker container tag: onap/org.onap.dcaegen2.services.heartbeat:2.1.0
1693        - Description: Generates missing heartbeat CL events based on configured threshold for VES heartbeats/VNF type.
1694
1695
1696 **Upgrade Notes**
1697
1698 The following components are upgraded from R3
1699     - Cloudify Manager:
1700        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:1.6.2
1701        - Description: DCAE's Cloudify Manager container is based on Cloudify Manager Community Version 19.01.24, which is based on Cloudify Manager 4.5.
1702     - K8S Bootstrap container:
1703        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.4.18
1704        - Description: K8s bootstrap container updated to include new plugin and remove DCAE Controller components which have been migrated to Helm chart.
1705     - Configuration Binding Service:
1706        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.3.0
1707        - Description: Code optimization and bug fixes
1708     - Deployment Handler
1709        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:4.0.1
1710        - Include updates for health and service endpoint check and bug fixes
1711     - Policy Handler
1712        - Docker container image tag: onap/org.onap.dcaegen2.platform.policy-handler:5.0.0
1713        - Description: Policy Handler supports the new lifecycle API's from Policy framework
1714     - Service Change Handler
1715        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.1.5
1716        - Description: No update from R3
1717     - Inventory API
1718        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.2.0
1719        - Description: Refactoring and updates for health and service endpoint check
1720     - VES Collector
1721        - Docker container image tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.4.5
1722        - Description : Authentication enhancement, refactoring and bug-fixes
1723     - Threshold Crossing Analytics
1724        - Docker container image tag: onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.1.2
1725        - Description: Config updates. Replaced Hadoop VM Cluster based file system with regular host file system; repackaged full TCA-CDAP stack into Docker container; transactional state separation from TCA in-memory to off-node Redis cluster for supporting horizontal scaling.
1726     - DataFile Collector
1727        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.1.3
1728        - Description : Code optimization, bug fixes, logging and performance improvement
1729     - PNF Registrator handler
1730        - Docker container tag: onap/org.onap.dcaegen2.services.prh.prh-app-server:1.2.4
1731        - Description : Code optimization, SDK integration, PNF-UPDATE flow support
1732     - HV-VES Collector
1733        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.1.0
1734        - Description : Code optimization, bug fixes, and enables SASL for kafka interface
1735     - SNMP Trap Collector
1736        - Docker container tag: onap/org.onap.dcaegen2.collectors.snmptrap:1.4.0
1737        - Description : Code coverage improvements
1738
1739
1740
1741
1742 Version: 3.0.1
1743 ==============
1744
1745 :Release Date: 2019-01-31
1746
1747 DCAE R3 Maintenance release includes following fixes
1748
1749 **Bug Fixes**
1750
1751 - DataFileCollector
1752      - DCAEGEN2-940
1753        Larger files of size 100Kb publish to DR
1754      - DCAEGEN2-941
1755        DFC error after running over 12 hours
1756      - DCAEGEN2-1001
1757        Multiple Fileready notification not handled
1758
1759 - HighVolume VES Collector (protobuf/tcp)
1760      - DCAEGEN2-976
1761        HV-VES not fully complaint to RTPM protocol (issue with CommonEventHeader.sequence)
1762
1763 - VESCollector (http)
1764      - DCAEGEN2-1035
1765        Issue with VES batch event publish
1766
1767 - Heat deployment
1768      - DCAEGEN2-1007
1769        Removing obsolete services configuration
1770
1771
1772 The following containers are updated in R3.0.1
1773
1774     - DataFile Collector
1775        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.0.5
1776     - HV-VES Collector
1777        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.0.2
1778     - VES Collector
1779        - Docker container tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.3.2
1780
1781 **Known Issues**
1782
1783 - An issue related to VESCollector basic authentication was noted and tracked under DCAEGEN2-1130. This configuration is not enabled by default for R3.0.1; and fix will be handled in Dublin
1784
1785 - Certificates under onap/org.onap.dcaegen2.deployments.tls-init-container:1.0.0 has expired March'2019 and impacting CL deployment from CLAMP. Follow below workaround to update the certificate
1786     kubectl get deployments -n onap | grep deployment-handler
1787     kubectl edit deployment -n onap dev-dcaegen2-dcae-deployment-handler
1788     Search and change tag onap/org.onap.dcaegen2.deployments.tls-init-container:1.0.0 to onap/org.onap.dcaegen2.deployments.tls-init-container:1.0.3
1789
1790
1791
1792
1793 Version: 3.0.0
1794 --------------
1795
1796 :Release Date: 2018-11-30
1797
1798 **New Features**
1799
1800 DCAE R3 improves upon previous release with the following new features:
1801
1802 - All DCAE R3 components are delivered as Docker container images.  The list of components is as follows.
1803     - Platform components
1804         - Cloudify Manager
1805         - Bootstrap container
1806         - Configuration Binding Service
1807         - Deployment Handler
1808         - Policy Handler
1809         - Service Change Handler
1810         - Inventory API
1811     - Service components
1812         - VES Collector
1813         - SNMP Collector
1814         - Threshold Crossing Analytics
1815         - Holmes Rule Management *
1816         - Holmes Engine Management *
1817     - Additional resources that DCAE utilizes:
1818         - Postgres Database
1819         - Redis Cluster Database
1820         - Consul Cluster
1821
1822     Notes:
1823         \*  These components are delivered by the Holmes project.
1824
1825 - DCAE R3 supports both OpenStack Heat Orchestration Template based deployment and OOM (Kubernetes) based deployment.
1826
1827     - Under Heat based deployment all DCAE component containers are deployed onto a single Docker host VM that is launched from an OpenStack Heat Orchestration Template as part of "stack creation".
1828     - Under OOM (Kubernetes) deployment all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster.
1829
1830 - DCAE R3 includes a new Cloudify Manager plugin (k8splugin) that is capable of expanding a Blueprint node specification written for Docker container to a full Kubernetes specification, with additional enhancements such as replica scaling, sidecar for logging to ONAP ELK stack, registering services to MSB, etc.
1831
1832 - All DCAE components are designed to support platform maturity requirements.
1833
1834
1835 **Source Code**
1836
1837 Source code of DCAE components are released under the following repositories on gerrit.onap.org:
1838     - dcaegen2
1839     - dcaegen2.analytics
1840     - dcaegen2.analytics.tca
1841     - dcaegen2.collectors
1842     - dcaegen2.collectors.snmptrap
1843     - dcaegen2.collectors.ves
1844     - dcaegen2.collectors.hv-ves
1845     - dcaegen2.collectors.datafile
1846     - dcaegen2.deployments
1847     - dcaegen2.platform
1848     - dcaegen2.platform.blueprints
1849     - dcaegen2.platform.cli
1850     - dcaegen2.platform.configbinding
1851     - dcaegen2.platform.deployment-handler
1852     - dcaegen2.platform.inventory-api
1853     - dcaegen2.platform.plugins
1854     - dcaegen2.platform.policy-handler
1855     - dcaegen2.platform.servicechange-handler
1856     - dcaegen2.services.heartbeat
1857     - dcaegen2.services.mapper
1858     - dcaegen2.services.prh
1859     - dcaegen2.utils
1860
1861 **Bug Fixes**
1862
1863 **Known Issues**
1864
1865 - DCAE utilizes Cloudify Manager as its declarative model based resource deployment engine.  Cloudify Manager is an open source upstream technology provided by Cloudify Inc. as a Docker image.  DCAE R2 does not provide additional enhancements towards Cloudify Manager's platform maturity.
1866
1867 **Security Notes**
1868
1869 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=28377647>`_.
1870
1871 Quick Links:
1872         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
1873
1874         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
1875
1876         - `Project Vulnerability Review Table for DCAE (Casablanca) <https://wiki.onap.org/pages/viewpage.action?pageId=41421168>`_
1877
1878
1879 **New component Notes**
1880 The following components are introduced in R3
1881
1882     - DataFile Collector
1883        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.0.4
1884        - Description : Bulk data file collector to fetch non-realtime PM data
1885     - PNF Registrator handler
1886        - Docker container tag: onap/org.onap.dcaegen2.services.prh.prh-app-server:1.1.1
1887        - Description : Recieves VES registration event and updates AAI and SO
1888     - HV-VES Collector
1889        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.0.0
1890        - Description : High Volume VES Collector for fetching real-time PM measurement data
1891     - SNMP Trap Collector
1892        - Docker container tag: onap/org.onap.dcaegen2.collectors.snmptrap:1.4.0
1893        - Description : Receives SNMP traps and publishes them to a  message router (DMAAP/MR) in json structure
1894
1895
1896 **Upgrade Notes**
1897
1898 The following components are upgraded from R2:
1899     - Cloudify Manager:
1900        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:1.4.2
1901        - Description: R3 DCAE's Cloudify Manager container is based on Cloudify Manager Community Version 18.7.23, which is based on Cloudify Manager 4.3.
1902     - Bootstrap container:
1903        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.4.5
1904        - Description: R3 DCAE no longer uses bootstrap container for Heat based deployment, -- deployment is done through cloud-init scripts and docker-compose specifications.  The bootstrap is for OOM (Kubernetes) based deployment.
1905     - Configuration Binding Service:
1906        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.2.3
1907        - Description: Configuration Binding Sevice now supports the new configuration policy format and support for TLS
1908     - Deployment Handler
1909        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:3.0.3
1910     - Policy Handler
1911        - Docker container image tag: onap/org.onap.dcaegen2.platform.policy-handler:4.4.0
1912        - Description: Policy Handler now supports the new configuration policy format and support for TLS
1913     - Service Change Handler
1914        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.1.5
1915        - Description: Refactoring.
1916     - Inventory API
1917        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.0.4
1918        - Description: Refactoring.
1919     - VES Collector
1920        - Docker container image tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.3.1
1921        - Description : Refactoring
1922     - Threshold Crossing Analytics
1923        - Docker container image tag: onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.1.0
1924        - Description: Replaced Hadoop VM Cluster based file system with regular host file system; repackaged full TCA-CDAP stack into Docker container; transactional state separation from TCA in-memory to off-node Redis cluster for supporting horizontal scaling.
1925
1926
1927
1928
1929 Version: 2.0.0
1930 ==============
1931
1932 :Release Date: 2018-06-07
1933
1934 **New Features**
1935
1936 DCAE R2 improves upon previous release with the following new features:
1937
1938 - All DCAE R2 components are delivered as Docker container images.  The list of components is as follows.
1939     - Platform components
1940         - Cloudify Manager
1941         - Bootstrap container
1942         - Configuration Binding Service
1943         - Deployment Handler
1944         - Policy Handler
1945         - Service Change Handler
1946         - Inventory API
1947     - Service components
1948         - VES Collector
1949         - SNMP Collector
1950         - Threshold Crossing Analytics
1951         - Holmes Rule Management *
1952         - Holmes Engine Management *
1953     - Additional resources that DCAE utilizes:
1954         - Postgres Database
1955         - Redis Cluster Database
1956         - Consul Cluster
1957
1958     Notes:
1959         \*  These components are delivered by the Holmes project and used as a DCAE analytics component in R2.
1960
1961 - DCAE R2 supports both OpenStack Heat Orchestration Template based deployment and OOM (Kubernetes) based deployment.
1962
1963     - Under Heat based deployment all DCAE component containers are deployed onto a single Docker host VM that is launched from an OpenStack Heat Orchestration Template as part of "stack creation".
1964     - Under OOM (Kubernetes) deployment all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster.
1965
1966 - DCAE R2 includes a new Cloudify Manager plugin (k8splugin) that is capable of expanding a Blueprint node specification written for Docker container to a full Kubernetes specification, with additional enhancements such as replica scaling, sidecar for logging to ONAP ELK stack, registering services to MSB, etc.
1967
1968 - All DCAE components are designed to support platform maturity requirements.
1969
1970
1971 **Source Code**
1972
1973 Source code of DCAE components are released under the following repositories on gerrit.onap.org:
1974     - dcaegen2
1975     - dcaegen2.analytics
1976     - dcaegen2.analytics.tca
1977     - dcaegen2.collectors
1978     - dcaegen2.collectors.snmptrap
1979     - dcaegen2.collectors.ves
1980     - dcaegen2.deployments
1981     - dcaegen2.platform
1982     - dcaegen2.platform.blueprints
1983     - dcaegen2.platform.cli
1984     - dcaegen2.platform.configbinding
1985     - dcaegen2.platform.deployment-handler
1986     - dcaegen2.platform.inventory-api
1987     - dcaegen2.platform.plugins
1988     - dcaegen2.platform.policy-handler
1989     - dcaegen2.platform.servicechange-handler
1990     - dcaegen2.services.heartbeat
1991     - dcaegen2.services.mapper
1992     - dcaegen2.services.prh
1993     - dcaegen2.utils
1994
1995 **Bug Fixes**
1996
1997 **Known Issues**
1998
1999 - DCAE utilizes Cloudify Manager as its declarative model based resource deployment engine.  Cloudify Manager is an open source upstream technology provided by Cloudify Inc. as a Docker image.  DCAE R2 does not provide additional enhancements towards Cloudify Manager's platform maturity.
2000
2001 **Security Notes**
2002
2003 DCAE 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. The DCAE open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=28377647>`_.
2004
2005 Quick Links:
2006         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
2007
2008         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
2009
2010         - `Project Vulnerability Review Table for DCAE (Beijing) <https://wiki.onap.org/pages/viewpage.action?pageId=28377647>`_
2011
2012
2013
2014 **Upgrade Notes**
2015
2016 The following components are upgraded from R1:
2017     - Cloudify Manager:
2018        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:1.3.0
2019        - Description: R2 DCAE's Cloudify Manager container is based on Cloudify Manager Community Version 18.2.28, which is based on Cloudify Manager 4.3.
2020     - Bootstrap container:
2021        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.1.11
2022        - Description: R2 DCAE no longer uses bootstrap container for Heat based deployment, -- deployment is done through cloud-init scripts and docker-compose specifications.  The bootstrap is for OOM (Kubernetes) based deployment.
2023     - Configuration Binding Service:
2024        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding:2.1.5
2025        - Description: Configuration Binding Sevice now supports the new configuration policy format.
2026     - Deployment Handler
2027        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:2.1.5
2028     - Policy Handler
2029        - Docker container image tag: onap/org.onap.dcaegen2.platform.policy-handler:2.4.5
2030        - Description: Policy Handler now supports the new configuration policy format.
2031     - Service Change Handler
2032        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.1.4
2033        - Description: Refactoring.
2034     - Inventory API
2035        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.0.1
2036        - Description: Refactoring.
2037     - VES Collector
2038        - Docker container image tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.2.0
2039     - Threshold Crossing Analytics
2040        - Docker container image tag: onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.1.0
2041        - Description: Replaced Hadoop VM Cluster based file system with regular host file system; repackaged full TCA-CDAP stack into Docker container; transactional state separation from TCA in-memory to off-node Redis cluster for supporting horizontal scaling.
2042
2043
2044
2045 Version: 1.0.0
2046 ==============
2047
2048 :Release Date: 2017-11-16
2049
2050
2051 **New Features**
2052
2053 DCAE is the data collection and analytics sub-system of ONAP.  Under ONAP Release 1 the DCAE
2054 sub-system includes both platform components and DCAE service components.  Collectively the ONAP R1
2055 DCAE components support the data collection and analytics functions for the R1 use cases, i.e. vFW,
2056 vDNS, vCPU, and vVoLTE.
2057
2058 Specifically, DCAE R1 includes the following components:
2059
2060 - Core platform
2061     - Cloudify manager
2062     - Consul cluster
2063 - Extended platform
2064     - Platform component docker host
2065     - Service component docker host
2066     - CDAP cluster
2067     - PostgreSQL database (*)
2068 - Platform docker container components
2069     - Configuration binding service
2070     - Deployment handler
2071     - Service change handler
2072     - Inventory
2073     - Policy handler
2074     - CDAP broker
2075 - Service components
2076     - Docker container components
2077         - VNF Event Streaming (VES) collector
2078         - Holmes (engine and rule management) **
2079     - CDAP analytics component
2080         - Threshold Crossing Analytics (TCA)
2081
2082 (*) Note: This component is delivered under the CCSDK project, deployed by DCAE under a single
2083 VM configuration as a shared PostgreSQL database for the R1 demos.  (CCSDK PostgreSQL supports
2084 other deployment configurations not used in the R1 demos.)
2085 (**) Note: This component is delivered under the Holmes project and used as a DCAE analytics component
2086 in R1.
2087
2088 Source codes of DCAE are released under the following repositories on gerrit.onap.org:
2089
2090 - dcaegen2
2091 - dcaegen2/analytics
2092 - dcaegen2/analytics/tca
2093 - dcaegen2/collectors
2094 - dcaegen2/collectors/snmptrap
2095 - dcaegen2/collectors/ves
2096 - dcaegen2/deployments
2097 - dcaegen2/platform
2098 - dcaegen2/platform/blueprints
2099 - dcaegen2/platform/cdapbroker
2100 - dcaegen2/platform/cli
2101 - dcaegen2/platform/configbinding
2102 - dcaegen2/platform/deployment-handler
2103 - dcaegen2/platform/inventory-api
2104 - dcaegen2/platform/plugins
2105 - dcaegen2/platform/policy-handler
2106 - dcaegen2/platform/servicechange-handler
2107 - dcaegen2/utils
2108
2109
2110 **Bug Fixes**
2111
2112 This is the initial release.
2113
2114
2115 **Known Issues**
2116
2117 - Need to test/integrate into an OpenStack environment other than Intel/Windriver Pod25.
2118 - Need to provide a dev configuration DCAE.
2119
2120
2121 **Security Issues**
2122
2123 - The DCAE Bootstrap container needs to have a secret key for accessing VMs that it launches.  This key is currently passed in as a Heat template parameter.  Tracked by JIRA `DCAEGEN2-178 <https://jira.onap.org/browse/DCAEGEN2-178>`_.>`_.
2124 - The RESTful API calls are generally not secure.  That is, they are either over http, or https without certificate verification.  Once there is an ONAP wide solution for handling certificates, DCAE will switch to https.
2125
2126
2127 **Upgrade Notes**
2128
2129 This is the initial release.
2130
2131
2132 **Deprecation Notes**
2133
2134 There is a GEN1 DCAE sub-system implementation existing in the pre-R1 ONAP Gerrit system.  The GEN1
2135 DCAE is deprecated by the R1 release.  The DCAE included in ONAP R1 is also known as DCAE GEN2.  The
2136 following Gerrit repos are voided and already locked as read-only.
2137
2138 - dcae
2139 - dcae/apod
2140 - dcae/apod/analytics
2141 - dcae/apod/buildtools
2142 - dcae/apod/cdap
2143 - dcae/collectors
2144 - dcae/collectors/ves
2145 - dcae/controller
2146 - dcae/controller/analytics
2147 - dcae/dcae-inventory
2148 - dcae/demo
2149 - dcae/demo/startup
2150 - dcae/demo/startup/aaf
2151 - dcae/demo/startup/controller
2152 - dcae/demo/startup/message-router
2153 - dcae/dmaapbc
2154 - dcae/operation
2155 - dcae/operation/utils
2156 - dcae/orch-dispatcher
2157 - dcae/pgaas
2158 - dcae/utils
2159 - dcae/utils/buildtools
2160 - ncomp
2161 - ncomp/cdap
2162 - ncomp/core
2163 - ncomp/docker
2164 - ncomp/maven
2165 - ncomp/openstack
2166 - ncomp/sirius
2167 - ncomp/sirius/manager
2168 - ncomp/utils
2169
2170
2171 **Other**
2172
2173 SNMP trap collector is seed code delivery only.