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