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-2020 AT&T Intellectual Property. All rights reserved.
   4
   5 Release Notes
   6 =============
   7
   8 Version: 6.0.0
   9 --------------
  10
  11
  12 **New Features**
  13
  14 DCAE R6 improves upon previous release with the following new features:
  15
  16 - DCAE Platform Enhancement
  17     - Introduction of Microservice and Onboarding Design (MOD) platform
  18     - Policy Notification support for DCAE components
  19     - Dynamic AAF certificate creation during component instantiation
  20     - Helm chart optimization to control each platform component separate
  21     - Dashboard Optimization
  22     - Blueprint generator tool to simplify deployment artifact creation
  23
  24
  25 - Following new services are delivered with Frankfurt
  26     - Event Processors
  27         - PM Subscription Handler
  28         - DataLake Handlers
  29     - Analytics/RCA
  30         - TCA-GEN2
  31 - Acumos Adapter (PoC)
  32
  33 Following is complete list of DCAE components available part of default ONAP/DCAE installation.
  34     - Platform components
  35         - Cloudify Manager (helm chart)
  36         - Bootstrap container (helm chart)
  37         - Configuration Binding Service (helm chart)
  38         - Deployment Handler (helm chart)
  39         - Policy Handler (helm chart
  40         - Service Change Handler (helm chart)
  41         - Inventory API (helm chart)
  42         - Dashboard (helm chart)
  43     - Service components
  44         - VES Collector
  45         - Threshold Crossing Analytics (TCA/CDAP)
  46         - HV-VES Collector
  47         - PNF-Registration Handler
  48         - Docker based Threshold Crossing Analytics (TCA-Gen2)
  49         - Holmes Rule Management *
  50         - Holmes Engine Management *
  51     - Additional resources that DCAE utilizes deployed using ONAP common charts:
  52         - Postgres Database
  53         - Mongo Database
  54         - Redis Cluster Database
  55         - Consul Cluster
  56
  57     Notes:
  58         \*  These components are delivered by the Holmes project.
  59
  60
  61
  62 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.
  63
  64
  65 - All DCAE components are designed to support platform maturity requirements.
  66
  67
  68 **Source Code**
  69
  70 Source code of DCAE components are released under the following repositories on gerrit.onap.org:
  71     - dcaegen2
  72     - dcaegen2.analytics.tca
  73     - dcaegen2.collectors.snmptrap
  74     - dcaegen2.collectors.ves
  75     - dcaegen2.collectors.hv-ves
  76     - dcaegen2.collectors.datafile
  77     - dcaegen2.collectors.restconf
  78     - dcaegen2.deployments
  79     - dcaegen2.platform.blueprints
  80     - dcaegen2.platform.cli
  81     - dcaegen2.platform.configbinding
  82     - dcaegen2.platform.deployment-handler
  83     - dcaegen2.platform.inventory-api
  84     - dcaegen2.platform.plugins
  85     - dcaegen2.platform.policy-handler
  86     - dcaegen2.platform.servicechange-handler
  87     - dcaegen2.services.heartbeat
  88     - dcaegen2.services.mapper
  89     - dcaegen2.services.pm-mapper
  90     - dcaegen2.services.prh
  91     - dcaegen2.services.son-handler
  92     - dcaegen2.services
  93     - dcaegen2.services.sdk
  94     - dcaegen2.utils
  95     - ccsdk.platform.plugins
  96     - ccsdk.dashboard
  97
  98 **Bug Fixes**
  99
 100 **Known Issues**
 101     * Blueprint generator issue (DCAEGEN2-2140)
 102
 103
 104 **Security Notes**
 105
 106 *Fixed Security Issues*
 107
 108     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
 109     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
 110     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
 111     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
 112     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
 113
 114 *Known Security Issues*
 115
 116         None
 117
 118
 119 *Known Vulnerabilities in Used Modules*
 120
 121         None
 122
 123 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>`_.
 124
 125 Quick Links:
 126         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 127
 128         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 129
 130 Artifacts released:
 131
 132 .. csv-table::
 133    :header: "Repository", "SubModules", "Version & Docker Image (if applicable)"
 134    :widths: auto
 135
 136    "dcaegen2/analytics/tca-gen2", "", "onap/org.onap.dcaegen2.analytics.tca-gen2.dcae-analytics-tca-web:1.0.1"
 137    "dcaegen2/collectors/datafile", "", "onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.3.0"
 138    "dcaegen2/collectors/hv-ves", "", "onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.4.0"
 139    "dcaegen2/collectors/restconf", "", "onap/org.onap.dcaegen2.collectors.restconfcollector:1.1.1"
 140    "dcaegen2/collectors/snmptrap", "", "onap/org.onap.dcaegen2.collectors.snmptrap:2.0.3"
 141    "dcaegen2/collectors/ves", "", "onap/org.onap.dcaegen2.collectors.ves.vescollector:1.5.4"
 142    "dcaegen2/deployments", "cm-container", "onap/org.onap.dcaegen2.deployments.cm-container:2.1.0"
 143    "dcaegen2/deployments", "consul-loader-container", "onap/org.onap.dcaegen2.deployments.consul-loader-container:1.0.0"
 144    "dcaegen2/deployments", "dcae-k8s-cleanup-container", "onap/org.onap.dcaegen2.deployments.dcae-k8s-cleanup-container:1.0.0"
 145    "dcaegen2/deployments", "healthcheck-container", "onap/org.onap.dcaegen2.deployments.healthcheck-container:1.3.0"
 146    "dcaegen2/deployments", "multisite-init-container", "onap/org.onap.dcaegen2.deployments.multisite-init-container:1.0.0"
 147    "dcaegen2/deployments", "redis-cluster-container", "onap/org.onap.dcaegen2.deployments.redis-cluster-container:1.0.0"
 148    "dcaegen2/deployments", "tca-cdap-container", "onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.2.2"
 149    "dcaegen2/deployments", "tls-init-container", "onap/org.onap.dcaegen2.deployments.tls-init-container:2.1.0"
 150    "dcaegen2/platform", "mod/onboardingapi", "onap/org.onap.dcaegen2.platform.mod.onboardingapi:2.12.1"
 151    "dcaegen2/platform", "mod/distributorapi", "onap/org.onap.dcaegen2.platform.mod.distributorapi:1.0.1"
 152    "dcaegen2/platform", "mod/designtool", "onap/org.onap.dcaegen2.platform.mod.designtool-web:1.0.2"
 153    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-http:1.0.1"
 154    "dcaegen2/platform", "mod/genprocessor", "onap/org.onap.dcaegen2.platform.mod.genprocessor-job:1.0.1"
 155    "dcaegen2/platform", "mod/designtool/mod-registry", "onap/org.onap.dcaegen2.platform.mod.mod-registry:1.0.0"
 156    "dcaegen2/platform", "mod/runtimeapi", "onap/org.onap.dcaegen2.platform.mod.runtime-web:1.0.1"
 157    "dcaegen2/platform/blueprints", "", "onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.12.4"
 158    "dcaegen2/platform/configbinding", "", "onap/org.onap.dcaegen2.platform.configbinding:2.5.2"
 159    "dcaegen2/platform/deployment-handler", "", "onap/org.onap.dcaegen2.platform.deployment-handler:4.3.0"
 160    "dcaegen2/platform/inventory-api", "", "onap/org.onap.dcaegen2.platform.inventory-api:3.4.1"
 161    "dcaegen2/platform/policy-handler", "", "onap/org.onap.dcaegen2.platform.policy-handler:5.1.0"
 162    "dcaegen2/platform/servicechange-handler", "", "onap/org.onap.dcaegen2.platform.servicechange-handler:1.3.2"
 163    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakefeeder:1.0.0"
 164    "dcaegen2/services", "components/datalake-handler", "onap/org.onap.dcaegen2.services.datalakeadminui:1.0.1"
 165    "dcaegen2/services", "components/pm-subscription-handler", "onap/org.onap.dcaegen2.services.pmsh:1.0.3"
 166    "dcaegen2/services", "components/bbs-event-processor", "onap/org.onap.dcaegen2.services.components.bbs-event-processor:2.0.0"
 167    "dcaegen2/services/heartbeat", "", "onap/org.onap.dcaegen2.services.heartbeat:2.1.0"
 168    "dcaegen2/services/mapper", "", "onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.0.1"
 169    "dcaegen2/services/pm-mapper", "", "onap/org.onap.dcaegen2.services.pm-mapper:1.3.1"
 170    "dcaegen2/services/prh", "", "onap/org.onap.dcaegen2.services.prh.prh-app-server:1.5.2"
 171    "dcaegen2/services/son-handler", "", "onap/org.onap.dcaegen2.services.son-handler:2.0.0"
 172    "dcaegen2/platform", "adapter/acumos", "onap/org.onap.dcaegen2.platform.adapter.acumos:1.0.1"
 173    "dcaegen2/platform", "mod/bpgenerator", "Blueprint Generator 1.3.1 (jar)"
 174    "dcaegen2/services/sdk", "", "DCAE SDK 1.3.5 (jar)"
 175    "ccsdk/dashboard", "", "onap/org.onap.ccsdk.dashboard.ccsdk-app-os:1.3.2"
 176
 177
 178
 179 Version: 5.0.1
 180 --------------
 181
 182 The offical El-Alto release (rolls up all 5.0.0 early drop deliverables) focused on technical debts and SECCOM priority work-items.
 183
 184 Following is summary of updates done for DCAEGEN2
 185
 186 **Security**
 187
 188 Following platform components were enabled for HTTPS
 189     - ConfigBindingService (CBS)
 190       -   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>`_
 191     - Cloudify Manager
 192     - InventoryAPI
 193     - Non-root container process (ConfigBindingService, InventoryAPI, ServiceChangeHandler, HV-VES, PRH, Son-handler)
 194
 195 All components interfacing with platform components were modified to support TLS interface
 196
 197 **Miscellaneous**
 198     - DCAE Dashboard deployment migration from cloudify blueprint to OOM/Chart
 199     - Dynamic Topic support via Dmaap plugin integration for DataFileCollector MS
 200     - Dynamic Topic support via Dmaap plugin integration for PM-Mapper service
 201     - CBS client libraries updated to remove consul service lookup
 202     - Image Optimization (ConfigBindingService, InventoryAPI, ServiceChangeHandler, HV-VES, PRH, Son-handler)
 203
 204
 205
 206 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.
 207     - Platform components
 208         - Cloudify Manager (helm chart)
 209         - Bootstrap container (helm chart)
 210         - Configuration Binding Service (helm chart)
 211         - Deployment Handler (helm chart)
 212         - Policy Handler (helm chart
 213         - Service Change Handler (helm chart)
 214         - Inventory API (helm chart)
 215         - Dashboard (helm charts)
 216     - Service components
 217         - VES Collector
 218         - SNMP Collector
 219         - Threshold Crossing Analytics
 220         - HV-VES Collector
 221         - PNF-Registration Handler
 222         - Holmes Rule Management *
 223         - Holmes Engine Management *
 224     - Additional resources that DCAE utilizes:
 225         - Postgres Database
 226         - Redis Cluster Database
 227         - Consul Cluster *
 228
 229     Notes:
 230         \*  These components are delivered by external ONAP project.
 231
 232 DCAE also includes below MS which can be deployed on-demand (via Dashboard or Cloudify CLI or CLAMP)
 233
 234     - Collectors
 235         - RESTConf collector
 236         - DataFile collector
 237     - Event Processors
 238         - VES Mapper
 239         - 3gpp PM-Mapper
 240         - BBS Event processor
 241     - Analytics/RCA
 242         - SON-Handler
 243         - Missing Heartbeat Ms
 244
 245 - All DCAE components are designed to support platform maturity requirements.
 246
 247
 248 **Source Code**
 249
 250 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.
 251     - dcaegen2
 252     - dcaegen2.analytics.tca
 253     - dcaegen2.collectors.snmptrap
 254     - dcaegen2.collectors.ves
 255     - dcaegen2.collectors.hv-ves
 256     - dcaegen2.collectors.datafile
 257     - dcaegen2.collectors.restconf
 258     - dcaegen2.deployments
 259     - dcaegen2.platform.blueprints
 260     - dcaegen2.platform.cli
 261     - dcaegen2.platform.configbinding
 262     - dcaegen2.platform.deployment-handler
 263     - dcaegen2.platform.inventory-api
 264     - dcaegen2.platform.plugins
 265     - dcaegen2.platform.policy-handler
 266     - dcaegen2.platform.servicechange-handler
 267     - dcaegen2.services.heartbeat
 268     - dcaegen2.services.mapper
 269     - dcaegen2.services.pm-mapper
 270     - dcaegen2.services.prh
 271     - dcaegen2.services.son-handler
 272     - dcaegen2.services
 273     - dcaegen2.services.sdk
 274     - dcaegen2.utils
 275     - ccsdk.platform.plugins
 276     - ccsdk.dashboard
 277
 278 **Bug Fixes**
 279     * k8splugin can generate deployment name > 63 chars (DCAEGEN2-1667)
 280     * CM container loading invalid Cloudify types file (DCAEGEN2-1685)
 281
 282
 283 **Known Issues**
 284     * Healthcheck/Readiness probe VES Collector when authentication is enabled (DCAEGEN2-1594)
 285
 286 **Security Notes**
 287
 288 *Fixed Security Issues*
 289     * Unsecured Swagger UI Interface in xdcae-datafile-collector. [`OJSI-28 <https://jira.onap.org/browse/OJSI-28>`_]
 290     * In default deployment DCAEGEN2 (xdcae-datafile-collector) exposes HTTP port 30223 outside of cluster. [`OJSI-109 <https://jira.onap.org/browse/OJSI-109>`_]
 291     * In default deployment DCAEGEN2 (xdcae-tca-analytics) exposes HTTP port 32010 outside of cluster. [`OJSI-161 <https://jira.onap.org/browse/OJSI-161>`_]
 292     * In default deployment DCAEGEN2 (dcae-datafile-collector) exposes HTTP port 30262 outside of cluster. [`OJSI-131 <https://jira.onap.org/browse/OJSI-131>`_]
 293     * CVE-2019-12126 - DCAE TCA exposes unprotected APIs/UIs on port 32010. [`OJSI-201 <https://jira.onap.org/browse/OJSI-201>`_]
 294
 295 *Known Security Issues*
 296     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
 297     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
 298     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
 299     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
 300     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
 301
 302 *Known Vulnerabilities in Used Modules*
 303
 304 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>`_.
 305
 306 Quick Links:
 307         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 308
 309         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 310
 311         - `Project Vulnerability Review Table for DCAE <https://wiki.onap.org/pages/viewpage.action?pageId=68540441>`_
 312
 313
 314 **Upgrade Notes**
 315
 316 The following components are upgraded from Dublin/R4 and El-Alto EarlyDrop deliverables.
 317     - K8S Bootstrap container:
 318        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.6.4
 319        - Description: K8s bootstrap container updated to interface with Cloudify using HTTPS; new k8s and Dmaap plugin version included; Dashboard deployment was removed.
 320     - Configuration Binding Service:
 321        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.5.2
 322        - Description: HTTPS support, Image optimization and non-root user
 323     - Inventory API
 324        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.4.0
 325        - Description: HTTPS support, container optmization and non-root user
 326     - DataFile Collector
 327        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.2.3
 328        - Description : Code optimization, bug fixes, dmaap plugin integration
 329     - SON Handler MS
 330        - Docker container tag: onap/org.onap.dcaegen2.services.son-handler:1.1.1
 331        - Description : Image optimization, bug fixes, CBS integration
 332     - VES Adapter/Mapper MS
 333        - Docker container tag: onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.0.1
 334        - Description : Image optimization & CBS periodic polling
 335     - PRH MS
 336        - Docker container tag: onap/org.onap.dcaegen2.services.prh.prh-app-server:1.3.1
 337        - Description : Code optimization, bug fixes and SDK alignment
 338     - HV-VES MS
 339        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.3.0
 340        - Description : Code optimization, bug fixes and SDK alignment
 341
 342 Version: 5.0.0
 343 --------------
 344
 345 El-Alto Early-drop focused on technical debts and SECCOM priority work-items.
 346
 347 Following is summary of updates done for DCAEGEN2
 348
 349 **Security**
 350
 351 Following platform components were enabled for HTTPS
 352     - ConfigBindingService (CBS)
 353       -   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>`_
 354     - Cloudify Manager
 355     - InventoryAPI
 356
 357 All components interfacing with platform components were modified to support TLS interface
 358
 359 **Miscellaneous**
 360     - DCAE Dashboard deployment migration from cloudify blueprint to OOM/Chart
 361     - Dynamic Topic support via Dmaap plugin integration for DataFileCollector MS
 362     - Dynamic Topic support via Dmaap plugin integration for PM-Mapper service
 363     - CBS client libraries updated to remove consul service lookup
 364
 365
 366
 367 **Bug Fixes**
 368     * k8splugin can generate deployment name > 63 chars (DCAEGEN2-1667)
 369     * CM container loading invalid Cloudify types file (DCAEGEN2-1685)
 370
 371
 372 **Known Issues**
 373     * Healthcheck/Readiness probe VES Collector when authentication is enabled (DCAEGEN2-1594)
 374
 375
 376 **Security Notes**
 377
 378 *Fixed Security Issues*
 379
 380 *Known Security Issues*
 381
 382     * Unsecured Swagger UI Interface in xdcae-datafile-collector. [`OJSI-28 <https://jira.onap.org/browse/OJSI-28>`_]
 383     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
 384     * In default deployment DCAEGEN2 (xdcae-datafile-collector) exposes HTTP port 30223 outside of cluster. [`OJSI-109 <https://jira.onap.org/browse/OJSI-109>`_]
 385     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
 386     * In default deployment DCAEGEN2 (dcae-datafile-collector) exposes HTTP port 30262 outside of cluster. [`OJSI-131 <https://jira.onap.org/browse/OJSI-131>`_]
 387     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
 388     * In default deployment DCAEGEN2 (xdcae-tca-analytics) exposes HTTP port 32010 outside of cluster. [`OJSI-161 <https://jira.onap.org/browse/OJSI-161>`_]
 389     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
 390     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
 391     * CVE-2019-12126 - DCAE TCA exposes unprotected APIs/UIs on port 32010. [`OJSI-201 <https://jira.onap.org/browse/OJSI-201>`_]
 392
 393 *Known Vulnerabilities in Used Modules*
 394
 395 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>`_.
 396
 397 Quick Links:
 398         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 399
 400         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 401
 402         - `Project Vulnerability Review Table for DCAE <https://wiki.onap.org/pages/viewpage.action?pageId=68540441>`_
 403
 404
 405 **Upgrade Notes**
 406
 407 The following components are upgraded from Dublin/R4.
 408     - Cloudify Manager:
 409        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:2.0.2
 410        - 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.
 411     - K8S Bootstrap container:
 412        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.6.2
 413        - Description: K8s bootstrap container updated to interface with Cloudify using HTTPS; new k8s and Dmaap plugin version included; Dashboard deployment was removed.
 414     - Configuration Binding Service:
 415        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.5.1
 416        - Description: HTTPS support, Image optimization and non-root user
 417     - Deployment Handler
 418        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:4.2.0
 419        - Description: Update to node10, uninstall workflow updates
 420     - Service Change Handler
 421        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.3.2
 422        - Description: HTTPS inventoryAPI support, container optmization and non-root user
 423     - Inventory API
 424        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.4.0
 425        - Description: HTTPS support, container optmization and non-root user
 426     - DataFile Collector
 427        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.2.2
 428        - Description : Code optimization, bug fixes, dmaap plugin integration
 429     - 3gpp PM-Mapper
 430        - Docker container tag: onap/org.onap.dcaegen2.services.pm-mapper:1.1.3
 431        - Description: Code optimization, bug fixes, dmaap plugin integration
 432
 433
 434
 435 Version: 4.0.0
 436 --------------
 437
 438 :Release Date: 2019-06-06
 439
 440 **New Features**
 441
 442 DCAE R4 improves upon previous release with the following new features:
 443
 444 - DCAE Platform Enhancement
 445     - Multisite K8S cluster deployment support for DCAE services (via K8S plugin)
 446     - Support helm chart deployment in DCAE using new Helm cloudify plugin
 447     - DCAE Healthcheck enhancement to cover static and dynamic deployments
 448     - Dynamic AAF based topic provisioning support through Dmaap cloudify plugin
 449     - Dashboard Integration (UI for deployment/verification)
 450     - PolicyHandler Enhancement to support new Policy Lifecycle API’s
 451     - Blueprint generator tool to simplify deployment artifact creation
 452     - Cloudify Manager resiliency
 453
 454 - Following new services are delivered with Dublin
 455     - Collectors
 456         - RESTConf collector
 457     - Event Processors
 458         - VES Mapper
 459         - 3gpp PM-Mapper
 460         - BBS Event processor
 461     - Analytics/RCA
 462         - SON-Handler
 463         - Heartbeat MS
 464
 465 Most platform components has been migrated to helm charts. Following is complete list of DCAE components available part of default ONAP/dcae installation.
 466     - Platform components
 467         - Cloudify Manager (helm chart)
 468         - Bootstrap container (helm chart)
 469         - Configuration Binding Service (helm chart)
 470         - Deployment Handler (helm chart)
 471         - Policy Handler (helm chart
 472         - Service Change Handler (helm chart)
 473         - Inventory API (helm chart)
 474         - Dashboard (Cloudify Blueprint)
 475     - Service components
 476         - VES Collector
 477         - SNMP Collector
 478         - Threshold Crossing Analytics
 479         - HV-VES Collector
 480         - PNF-Registration Handler
 481         - Holmes Rule Management *
 482         - Holmes Engine Management *
 483     - Additional resources that DCAE utilizes:
 484         - Postgres Database
 485         - Redis Cluster Database
 486         - Consul Cluster *
 487
 488     Notes:
 489         \*  These components are delivered by the Holmes project.
 490
 491
 492 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.
 493
 494 - All DCAE components are designed to support platform maturity requirements.
 495
 496
 497 **Source Code**
 498
 499 Source code of DCAE components are released under the following repositories on gerrit.onap.org:
 500     - dcaegen2
 501     - dcaegen2.analytics.tca
 502     - dcaegen2.collectors.snmptrap
 503     - dcaegen2.collectors.ves
 504     - dcaegen2.collectors.hv-ves
 505     - dcaegen2.collectors.datafile
 506     - dcaegen2.collectors.restconf
 507     - dcaegen2.deployments
 508     - dcaegen2.platform.blueprints
 509     - dcaegen2.platform.cli
 510     - dcaegen2.platform.configbinding
 511     - dcaegen2.platform.deployment-handler
 512     - dcaegen2.platform.inventory-api
 513     - dcaegen2.platform.plugins
 514     - dcaegen2.platform.policy-handler
 515     - dcaegen2.platform.servicechange-handler
 516     - dcaegen2.services.heartbeat
 517     - dcaegen2.services.mapper
 518     - dcaegen2.services.pm-mapper
 519     - dcaegen2.services.prh
 520     - dcaegen2.services.son-handler
 521     - dcaegen2.services
 522     - dcaegen2.services.sdk
 523     - dcaegen2.utils
 524     - ccsdk.platform.plugins
 525     - ccsdk.dashboard
 526
 527 **Bug Fixes**
 528
 529 **Known Issues**
 530     * Healthcheck/Readiness probe VES Collector when authentication is enabled (DCAEGEN2-1594)
 531
 532
 533 **Security Notes**
 534
 535 *Fixed Security Issues*
 536
 537 *Known Security Issues*
 538
 539     * Unsecured Swagger UI Interface in xdcae-datafile-collector. [`OJSI-28 <https://jira.onap.org/browse/OJSI-28>`_]
 540     * Unsecured Swagger UI Interface in xdcae-ves-collector. [`OJSI-30 <https://jira.onap.org/browse/OJSI-30>`_]
 541     * In default deployment DCAEGEN2 (xdcae-datafile-collector) exposes HTTP port 30223 outside of cluster. [`OJSI-109 <https://jira.onap.org/browse/OJSI-109>`_]
 542     * In default deployment DCAEGEN2 (xdcae-ves-collector) exposes HTTP port 30235 outside of cluster. [`OJSI-116 <https://jira.onap.org/browse/OJSI-116>`_]
 543     * In default deployment DCAEGEN2 (dcae-datafile-collector) exposes HTTP port 30262 outside of cluster. [`OJSI-131 <https://jira.onap.org/browse/OJSI-131>`_]
 544     * In default deployment DCAEGEN2 (xdcae-dashboard) exposes HTTP port 30418 outside of cluster. [`OJSI-159 <https://jira.onap.org/browse/OJSI-159>`_]
 545     * In default deployment DCAEGEN2 (xdcae-tca-analytics) exposes HTTP port 32010 outside of cluster. [`OJSI-161 <https://jira.onap.org/browse/OJSI-161>`_]
 546     * In default deployment DCAEGEN2 (dcae-redis) exposes redis port 30286 outside of cluster. [`OJSI-187 <https://jira.onap.org/browse/OJSI-187>`_]
 547     * In default deployment DCAEGEN2 (config-binding-service) exposes HTTP port 30415 outside of cluster. [`OJSI-195 <https://jira.onap.org/browse/OJSI-195>`_]
 548     * CVE-2019-12126 - DCAE TCA exposes unprotected APIs/UIs on port 32010. [`OJSI-201 <https://jira.onap.org/browse/OJSI-201>`_]
 549
 550 *Known Vulnerabilities in Used Modules*
 551
 552 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>`_.
 553
 554 Quick Links:
 555         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 556
 557         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 558
 559         - `Project Vulnerability Review Table for DCAE <https://wiki.onap.org/pages/viewpage.action?pageId=51282478>`_
 560
 561
 562 **New component Notes**
 563 The following components are introduced in R4
 564
 565     - Dashboard
 566        - Docker container tag: onap/org.onap.ccsdk.dashboard.ccsdk-app-os:1.1.0
 567        - Description: Dashboard provides an UI interface for users/operation to deploy and manage service components in DCAE
 568     - Blueprint generator
 569        - Java artifact : /org/onap/dcaegen2/platform/cli/blueprint-generator/1.0.0/blueprint-generator-1.0.0.jar
 570        - Description: Tool to generate the deployment artifact (cloudify blueprints) based on component spec
 571     - RESTConf collector
 572        - Docker container tag: onap/org.onap.dcaegen2.collectors.restconfcollector:1.1.1
 573        - Description: Provides RESTConf interfaces to events from external domain controllers
 574     - VES/Universal Mapper
 575        - Docker container tag: onap/org.onap.dcaegen2.services.mapper.vesadapter.universalvesadaptor:1.0.0
 576        - Description: Standardizes events recieved from SNMP and RESTConf collector into VES for further processing with DCAE analytics services
 577     - 3gpp PM-Mapper
 578        - Docker container tag: onap/org.onap.dcaegen2.services.pm-mapper:1.0.1
 579        - Description: Transforms 3gpp data feed recieved from DMAAP-DR into VES events
 580     - BBS Event processor
 581        - Docker container tag: onap/org.onap.dcaegen2.services.components.bbs-event-processor:1.0.0
 582        - Description: Handles PNF-Reregistration and CPE authentication events and generate CL events
 583     - SON-Handler
 584        - Docker container tag: onap/org.onap.dcaegen2.services.son-handler:1.0.3
 585        - Description: Supports PC-ANR optimization analysis and generating CL events output
 586     - Heartbeat MS
 587        - Docker container tag: onap/org.onap.dcaegen2.services.heartbeat:2.1.0
 588        - Description: Generates missing heartbeat CL events based on configured threshold for VES heartbeats/VNF type.
 589
 590
 591 **Upgrade Notes**
 592
 593 The following components are upgraded from R3
 594     - Cloudify Manager:
 595        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:1.6.2
 596        - Description: DCAE's Cloudify Manager container is based on Cloudify Manager Community Version 19.01.24, which is based on Cloudify Manager 4.5.
 597     - K8S Bootstrap container:
 598        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.4.18
 599        - Description: K8s bootstrap container updated to include new plugin and remove DCAE Controller components which have been migrated to Helm chart.
 600     - Configuration Binding Service:
 601        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.3.0
 602        - Description: Code optimization and bug fixes
 603     - Deployment Handler
 604        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:4.0.1
 605        - Include updates for health and service endpoint check and bug fixes
 606     - Policy Handler
 607        - Docker container image tag: onap/org.onap.dcaegen2.platform.policy-handler:5.0.0
 608        - Description: Policy Handler supports the new lifecycle API's from Policy framework
 609     - Service Change Handler
 610        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.1.5
 611        - Description: No update from R3
 612     - Inventory API
 613        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.2.0
 614        - Description: Refactoring and updates for health and service endpoint check
 615     - VES Collector
 616        - Docker container image tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.4.5
 617        - Description : Authentication enhancement, refactoring and bug-fixes
 618     - Threshold Crossing Analytics
 619        - Docker container image tag: onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.1.2
 620        - 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.
 621     - DataFile Collector
 622        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.1.3
 623        - Description : Code optimization, bug fixes, logging and performance improvement
 624     - PNF Registrator handler
 625        - Docker container tag: onap/org.onap.dcaegen2.services.prh.prh-app-server:1.2.4
 626        - Description : Code optimization, SDK integration, PNF-UPDATE flow support
 627     - HV-VES Collector
 628        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.1.0
 629        - Description : Code optimization, bug fixes, and enables SASL for kafka interface
 630     - SNMP Trap Collector
 631        - Docker container tag: onap/org.onap.dcaegen2.collectors.snmptrap:1.4.0
 632        - Description : Code coverage improvements
 633
 634
 635
 636
 637 Version: 3.0.1
 638 --------------
 639
 640 :Release Date: 2019-01-31
 641
 642 DCAE R3 Maintenance release includes following fixes
 643
 644 **Bug Fixes**
 645
 646 - DataFileCollector
 647      - DCAEGEN2-940
 648        Larger files of size 100Kb publish to DR
 649      - DCAEGEN2-941
 650        DFC error after running over 12 hours
 651      - DCAEGEN2-1001
 652        Multiple Fileready notification not handled
 653
 654 - HighVolume VES Collector (protobuf/tcp)
 655      - DCAEGEN2-976
 656        HV-VES not fully complaint to RTPM protocol (issue with CommonEventHeader.sequence)
 657
 658 - VESCollector (http)
 659      - DCAEGEN2-1035
 660        Issue with VES batch event publish
 661
 662 - Heat deployment
 663      - DCAEGEN2-1007
 664        Removing obsolete services configuration
 665
 666
 667 The following containers are updated in R3.0.1
 668
 669     - DataFile Collector
 670        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.0.5
 671     - HV-VES Collector
 672        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.0.2
 673     - VES Collector
 674        - Docker container tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.3.2
 675
 676 **Known Issues**
 677
 678 - 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
 679
 680 - 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
 681     kubectl get deployments -n onap | grep deployment-handler
 682     kubectl edit deployment -n onap dev-dcaegen2-dcae-deployment-handler
 683     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
 684
 685
 686
 687
 688 Version: 3.0.0
 689 --------------
 690
 691 :Release Date: 2018-11-30
 692
 693 **New Features**
 694
 695 DCAE R3 improves upon previous release with the following new features:
 696
 697 - All DCAE R3 components are delivered as Docker container images.  The list of components is as follows.
 698     - Platform components
 699         - Cloudify Manager
 700         - Bootstrap container
 701         - Configuration Binding Service
 702         - Deployment Handler
 703         - Policy Handler
 704         - Service Change Handler
 705         - Inventory API
 706     - Service components
 707         - VES Collector
 708         - SNMP Collector
 709         - Threshold Crossing Analytics
 710         - Holmes Rule Management *
 711         - Holmes Engine Management *
 712     - Additional resources that DCAE utilizes:
 713         - Postgres Database
 714         - Redis Cluster Database
 715         - Consul Cluster
 716
 717     Notes:
 718         \*  These components are delivered by the Holmes project.
 719
 720 - DCAE R3 supports both OpenStack Heat Orchestration Template based deployment and OOM (Kubernetes) based deployment.
 721
 722     - 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".
 723     - Under OOM (Kubernetes) deployment all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster.
 724
 725 - 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.
 726
 727 - All DCAE components are designed to support platform maturity requirements.
 728
 729
 730 **Source Code**
 731
 732 Source code of DCAE components are released under the following repositories on gerrit.onap.org:
 733     - dcaegen2
 734     - dcaegen2.analytics
 735     - dcaegen2.analytics.tca
 736     - dcaegen2.collectors
 737     - dcaegen2.collectors.snmptrap
 738     - dcaegen2.collectors.ves
 739     - dcaegen2.collectors.hv-ves
 740     - dcaegen2.collectors.datafile
 741     - dcaegen2.deployments
 742     - dcaegen2.platform
 743     - dcaegen2.platform.blueprints
 744     - dcaegen2.platform.cli
 745     - dcaegen2.platform.configbinding
 746     - dcaegen2.platform.deployment-handler
 747     - dcaegen2.platform.inventory-api
 748     - dcaegen2.platform.plugins
 749     - dcaegen2.platform.policy-handler
 750     - dcaegen2.platform.servicechange-handler
 751     - dcaegen2.services.heartbeat
 752     - dcaegen2.services.mapper
 753     - dcaegen2.services.prh
 754     - dcaegen2.utils
 755
 756 **Bug Fixes**
 757
 758 **Known Issues**
 759
 760 - 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.
 761
 762 **Security Notes**
 763
 764 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>`_.
 765
 766 Quick Links:
 767         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 768
 769         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 770
 771         - `Project Vulnerability Review Table for DCAE <https://wiki.onap.org/pages/viewpage.action?pageId=41421168>`_
 772
 773
 774 **New component Notes**
 775 The following components are introduced in R3
 776
 777     - DataFile Collector
 778        - Docker container tag: onap/org.onap.dcaegen2.collectors.datafile.datafile-app-server:1.0.4
 779        - Description : Bulk data file collector to fetch non-realtime PM data
 780     - PNF Registrator handler
 781        - Docker container tag: onap/org.onap.dcaegen2.services.prh.prh-app-server:1.1.1
 782        - Description : Recieves VES registration event and updates AAI and SO
 783     - HV-VES Collector
 784        - Docker container tag: onap/org.onap.dcaegen2.collectors.hv-ves.hv-collector-main:1.0.0
 785        - Description : High Volume VES Collector for fetching real-time PM measurement data
 786     - SNMP Trap Collector
 787        - Docker container tag: onap/org.onap.dcaegen2.collectors.snmptrap:1.4.0
 788        - Description : Receives SNMP traps and publishes them to a  message router (DMAAP/MR) in json structure
 789
 790
 791 **Upgrade Notes**
 792
 793 The following components are upgraded from R2:
 794     - Cloudify Manager:
 795        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:1.4.2
 796        - 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.
 797     - Bootstrap container:
 798        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.4.5
 799        - 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.
 800     - Configuration Binding Service:
 801        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding.app-app:2.2.3
 802        - Description: Configuration Binding Sevice now supports the new configuration policy format and support for TLS
 803     - Deployment Handler
 804        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:3.0.3
 805     - Policy Handler
 806        - Docker container image tag: onap/org.onap.dcaegen2.platform.policy-handler:4.4.0
 807        - Description: Policy Handler now supports the new configuration policy format and support for TLS
 808     - Service Change Handler
 809        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.1.5
 810        - Description: Refactoring.
 811     - Inventory API
 812        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.0.4
 813        - Description: Refactoring.
 814     - VES Collector
 815        - Docker container image tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.3.1
 816        - Description : Refactoring
 817     - Threshold Crossing Analytics
 818        - Docker container image tag: onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.1.0
 819        - 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.
 820
 821
 822
 823
 824 Version: 2.0.0
 825 --------------
 826
 827 :Release Date: 2018-06-07
 828
 829 **New Features**
 830
 831 DCAE R2 improves upon previous release with the following new features:
 832
 833 - All DCAE R2 components are delivered as Docker container images.  The list of components is as follows.
 834     - Platform components
 835         - Cloudify Manager
 836         - Bootstrap container
 837         - Configuration Binding Service
 838         - Deployment Handler
 839         - Policy Handler
 840         - Service Change Handler
 841         - Inventory API
 842     - Service components
 843         - VES Collector
 844         - SNMP Collector
 845         - Threshold Crossing Analytics
 846         - Holmes Rule Management *
 847         - Holmes Engine Management *
 848     - Additional resources that DCAE utilizes:
 849         - Postgres Database
 850         - Redis Cluster Database
 851         - Consul Cluster
 852
 853     Notes:
 854         \*  These components are delivered by the Holmes project and used as a DCAE analytics component in R2.
 855
 856 - DCAE R2 supports both OpenStack Heat Orchestration Template based deployment and OOM (Kubernetes) based deployment.
 857
 858     - 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".
 859     - Under OOM (Kubernetes) deployment all DCAE component containers are deployed as Kubernetes Pods/Deployments/Services into Kubernetes cluster.
 860
 861 - 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.
 862
 863 - All DCAE components are designed to support platform maturity requirements.
 864
 865
 866 **Source Code**
 867
 868 Source code of DCAE components are released under the following repositories on gerrit.onap.org:
 869     - dcaegen2
 870     - dcaegen2.analytics
 871     - dcaegen2.analytics.tca
 872     - dcaegen2.collectors
 873     - dcaegen2.collectors.snmptrap
 874     - dcaegen2.collectors.ves
 875     - dcaegen2.deployments
 876     - dcaegen2.platform
 877     - dcaegen2.platform.blueprints
 878     - dcaegen2.platform.cli
 879     - dcaegen2.platform.configbinding
 880     - dcaegen2.platform.deployment-handler
 881     - dcaegen2.platform.inventory-api
 882     - dcaegen2.platform.plugins
 883     - dcaegen2.platform.policy-handler
 884     - dcaegen2.platform.servicechange-handler
 885     - dcaegen2.services.heartbeat
 886     - dcaegen2.services.mapper
 887     - dcaegen2.services.prh
 888     - dcaegen2.utils
 889
 890 **Bug Fixes**
 891
 892 **Known Issues**
 893
 894 - 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.
 895
 896 **Security Notes**
 897
 898 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>`_.
 899
 900 Quick Links:
 901         - `DCAE project page <https://wiki.onap.org/display/DW/Data+Collection+Analytics+and+Events+Project>`_
 902
 903         - `Passing Badge information for DCAE <https://bestpractices.coreinfrastructure.org/en/projects/1718>`_
 904
 905         - `Project Vulnerability Review Table for DCAE <https://wiki.onap.org/pages/viewpage.action?pageId=28377647>`_
 906
 907
 908
 909 **Upgrade Notes**
 910
 911 The following components are upgraded from R1:
 912     - Cloudify Manager:
 913        - Docker container tag: onap/org.onap.dcaegen2.deployments.cm-container:1.3.0
 914        - 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.
 915     - Bootstrap container:
 916        - Docker container tag: onap/org.onap.dcaegen2.deployments.k8s-bootstrap-container:1.1.11
 917        - 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.
 918     - Configuration Binding Service:
 919        - Docker container tag: onap/org.onap.dcaegen2.platform.configbinding:2.1.5
 920        - Description: Configuration Binding Sevice now supports the new configuration policy format.
 921     - Deployment Handler
 922        - Docker container image tag: onap/org.onap.dcaegen2.platform.deployment-handler:2.1.5
 923     - Policy Handler
 924        - Docker container image tag: onap/org.onap.dcaegen2.platform.policy-handler:2.4.5
 925        - Description: Policy Handler now supports the new configuration policy format.
 926     - Service Change Handler
 927        - Docker container image tag: onap/org.onap.dcaegen2.platform.servicechange-handler:1.1.4
 928        - Description: Refactoring.
 929     - Inventory API
 930        - Docker container image tag: onap/org.onap.dcaegen2.platform.inventory-api:3.0.1
 931        - Description: Refactoring.
 932     - VES Collector
 933        - Docker container image tag: onap/org.onap.dcaegen2.collectors.ves.vescollector:1.2.0
 934     - Threshold Crossing Analytics
 935        - Docker container image tag: onap/org.onap.dcaegen2.deployments.tca-cdap-container:1.1.0
 936        - 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.
 937
 938
 939
 940 Version: 1.0.0
 941 --------------
 942
 943 :Release Date: 2017-11-16
 944
 945
 946 **New Features**
 947
 948 DCAE is the data collection and analytics sub-system of ONAP.  Under ONAP Release 1 the DCAE
 949 sub-system includes both platform components and DCAE service components.  Collectively the ONAP R1
 950 DCAE components support the data collection and analytics functions for the R1 use cases, i.e. vFW,
 951 vDNS, vCPU, and vVoLTE.
 952
 953 Specifically, DCAE R1 includes the following components:
 954
 955 - Core platform
 956     - Cloudify manager
 957     - Consul cluster
 958 - Extended platform
 959     - Platform component docker host
 960     - Service component docker host
 961     - CDAP cluster
 962     - PostgreSQL database (*)
 963 - Platform docker container components
 964     - Configuration binding service
 965     - Deployment handler
 966     - Service change handler
 967     - Inventory
 968     - Policy handler
 969     - CDAP broker
 970 - Service components
 971     - Docker container components
 972         - VNF Event Streaming (VES) collector
 973         - Holmes (engine and rule management) **
 974     - CDAP analytics component
 975         - Threshold Crossing Analytics (TCA)
 976
 977 (*) Note: This component is delivered under the CCSDK project, deployed by DCAE under a single
 978 VM configuration as a shared PostgreSQL database for the R1 demos.  (CCSDK PostgreSQL supports
 979 other deployment configurations not used in the R1 demos.)
 980 (**) Note: This component is delivered under the Holmes project and used as a DCAE analytics component
 981 in R1.
 982
 983 Source codes of DCAE are released under the following repositories on gerrit.onap.org:
 984
 985 - dcaegen2
 986 - dcaegen2/analytics
 987 - dcaegen2/analytics/tca
 988 - dcaegen2/collectors
 989 - dcaegen2/collectors/snmptrap
 990 - dcaegen2/collectors/ves
 991 - dcaegen2/deployments
 992 - dcaegen2/platform
 993 - dcaegen2/platform/blueprints
 994 - dcaegen2/platform/cdapbroker
 995 - dcaegen2/platform/cli
 996 - dcaegen2/platform/configbinding
 997 - dcaegen2/platform/deployment-handler
 998 - dcaegen2/platform/inventory-api
 999 - dcaegen2/platform/plugins
1000 - dcaegen2/platform/policy-handler
1001 - dcaegen2/platform/servicechange-handler
1002 - dcaegen2/utils
1003
1004
1005 **Bug Fixes**
1006
1007 This is the initial release.
1008
1009
1010 **Known Issues**
1011
1012 - Need to test/integrate into an OpenStack environment other than Intel/Windriver Pod25.
1013 - Need to provide a dev configuration DCAE.
1014
1015
1016 **Security Issues**
1017
1018 - 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>`_.>`_.
1019 - 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.
1020
1021
1022 **Upgrade Notes**
1023
1024 This is the initial release.
1025
1026
1027 **Deprecation Notes**
1028
1029 There is a GEN1 DCAE sub-system implementation existing in the pre-R1 ONAP Gerrit system.  The GEN1
1030 DCAE is deprecated by the R1 release.  The DCAE included in ONAP R1 is also known as DCAE GEN2.  The
1031 following Gerrit repos are voided and already locked as read-only.
1032
1033 - dcae
1034 - dcae/apod
1035 - dcae/apod/analytics
1036 - dcae/apod/buildtools
1037 - dcae/apod/cdap
1038 - dcae/collectors
1039 - dcae/collectors/ves
1040 - dcae/controller
1041 - dcae/controller/analytics
1042 - dcae/dcae-inventory
1043 - dcae/demo
1044 - dcae/demo/startup
1045 - dcae/demo/startup/aaf
1046 - dcae/demo/startup/controller
1047 - dcae/demo/startup/message-router
1048 - dcae/dmaapbc
1049 - dcae/operation
1050 - dcae/operation/utils
1051 - dcae/orch-dispatcher
1052 - dcae/pgaas
1053 - dcae/utils
1054 - dcae/utils/buildtools
1055 - ncomp
1056 - ncomp/cdap
1057 - ncomp/core
1058 - ncomp/docker
1059 - ncomp/maven
1060 - ncomp/openstack
1061 - ncomp/sirius
1062 - ncomp/sirius/manager
1063 - ncomp/utils
1064
1065
1066 **Other**
1067
1068 SNMP trap collector is seed code delivery only.