Add old CLAMP release notes for tracability
[policy/parent.git] / docs / clamp / pre-migration-release-notes.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3 .. Copyright (c) 2017-2020 AT&T Intellectual Property.  All rights reserved.
4 .. _clamp-pre-migration-release-notes:
5
6 Pre Migration (Guilin and earlier) Release Notes for CLAMP
7 ==========================================================
8
9 .. warning:: The CLAMP project was migrated to policy-clamp in the Policy Framework in the Honolulu release. For CLAMP release notes for the Hinolulu and subsequent
10              releases, please see the policy-clamp related release notes in the :ref:`POLICY Framework Release Notes<release_notes>`
11
12 Version: 5.1.0 (Guilin)
13 --------------------------
14
15 :Release Date: 2020-11-19
16
17 **New Features**
18
19 The Guilin release of the Control Loop Automation Management Platform (CLAMP).
20
21 The main goal of the Guilin release was to:
22
23     - Complete integration to CDS for Actor/Action selection.
24     - SECCOM Perform Software Composition Analysis - Vulnerability tables (TSC must have).
25     - SECCOM Password removal from OOM HELM charts (TSC must have) - implementation of certinInitializer to get AAF certificates at oom deployment time.
26
27 **Bug Fixes**
28
29         - The full list of implemented user stories and epics is available on `CLAMP R7 - M1 release planning <https://wiki.onap.org/display/DW/CLAMP+R7+-+M1+Release+Planning>`_
30         - The full list of issues(bugs) solved, is available on `CLAMP R7 - Guilin list of solved issues(bugs) <https://wiki.onap.org/pages/viewpage.action?pageId=93000705>`_
31
32 **Known Issues**
33
34 **Security Notes**
35
36 *Fixed Security Issues*
37
38 *Known Security Issues*
39
40 *Known Vulnerabilities in Used Modules*
41
42 CLAMP 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 actions to be taken in future release.
43
44 Quick Links:
45         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
46
47         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
48
49 **Upgrade Notes**
50
51     - The Upgrade strategy for Guilin can be found here:`<https://wiki.onap.org/display/DW/Frankfurt+CLAMP+Container+upgrade+strategy>`_
52     - New Docker Containers are available. the list of containers composing this release are below:
53        - clamp-backend: nexus3.onap.org:10001/onap/clamp-backend 5.1.5
54        - clamp-frontend: nexus3.onap.org:10001/onap/clamp-frontend 5.1.5
55        - clamp-dash-es: nexus3.onap.org:10001/onap/clamp-dashboard-elasticsearch 5.0.4
56        - clamp-dash-kibana: nexus3.onap.org:10001/onap/clamp-dashboard-kibana 5.0.4
57        - clamp-dash-logstash: nexus3.onap.org:10001/onap/clamp-dashboard-logstash 5.0.4
58
59
60 Version: 5.0.7 (Frankfurt maintenance release tag 6.0.0)
61 --------------------------------------------------------
62
63 :Release Date: 2020-08-17
64
65 **Bug Fixes**
66
67         - `CLAMP-878 <https://jira.onap.org/browse/CLAMP-885>`_ Clamp backend pod fails with mariaDB server error
68         - `CLAMP-885 <https://jira.onap.org/browse/CLAMP-885>`_ CLAMP update documentation
69
70 **Known Issues**
71     - `CLAMP-856 <https://jira.onap.org/browse/CLAMP-856>`_ CLAMP should not display all CDS workflow properties
72     - Other more minor issues are captured in the following page:`CLAMP known Frankfurt issues <https://wiki.onap.org/display/DW/CLAMP+R6+-+Frankfurt+known+issues%28bugs%29+-+to+be+solved+in+futur+Releases>`_
73
74 **Security Notes**
75
76 N/A
77
78 *Fixed Security Issues*
79
80 *Known Security Issues*
81
82 *Known Vulnerabilities in Used Modules*
83
84 CLAMP 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 actions to be taken in future release.
85
86 Quick Links:
87         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
88         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
89
90 **Upgrade Notes**
91
92     - The Upgrade strategy for Frankfurt can be found here:`<https://wiki.onap.org/display/DW/Frankfurt+CLAMP+Container+upgrade+strategy>`_
93     - New Docker Containers are available. the list of containers composing this release are below:
94
95        - clamp-backend-filebeat-onap: docker.elastic.co/beats/filebeat 5.5.0
96        - clamp-backend: nexus3.onap.org:10001/onap/clamp-backend 5.0.7
97        - clamp-frontend: nexus3.onap.org:10001/onap/clamp-frontend 5.0.7
98        - clamp-dash-es: nexus3.onap.org:10001/onap/clamp-dashboard-elasticsearch 5.0.3
99        - clamp-dash-kibana: nexus3.onap.org:10001/onap/clamp-dashboard-kibana 5.0.3
100        - clamp-dash-logstash: nexus3.onap.org:10001/onap/clamp-dashboard-logstash 5.0.3
101
102 Version: 5.0.1 (Frankfurt)
103 --------------------------
104
105 :Release Date: 2020-05-12
106
107 **New Features**
108
109 The Frankfurt release is the seventh release of the Control Loop Automation Management Platform (CLAMP).
110
111 The main goal of the Frankfurt release was to:
112
113     - implementing a new Control Loop creation flow: Self Serve Control Loop(partially done will be continued in next release).
114     - Add Tosca policy-model support for Operational Policies definitions.
115     - Add integration to CDS for Actor/Action selection.
116     - Move from SearchGuard to OpenDistro.
117     - Document(high level) current upgrade component strategy (TSC must have).
118     - SECCOM Perform Software Composition Analysis - Vulnerability tables (TSC must have).
119     - SECCOM Password removal from OOM HELM charts (TSC must have).
120     - SECCOM HTTPS communication vs. HTTP (TSC must have)
121
122 **Bug Fixes**
123
124         - The full list of implemented user stories and epics is available on `Frankfurt CLAMP M1 release planning <https://wiki.onap.org/display/DW/CLAMP+R6+-+M1+Release+Planning>`_
125         - The full list of issues(bugs) solved, is available on `CLAMP R6 - Frankfurt list of solved issues(bugs) <https://wiki.onap.org/pages/viewpage.action?pageId=84648915>`_
126
127 **Known Issues**
128     - `CLAMP-856 <https://jira.onap.org/browse/CLAMP-856>`_ CLAMP should not display all CDS workflow properties
129
130 **Security Notes**
131
132 *Fixed Security Issues*
133
134 *Known Security Issues*
135
136 *Known Vulnerabilities in Used Modules*
137
138 CLAMP 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 actions to be taken in future release.
139
140 Quick Links:
141         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
142
143         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
144
145 **Upgrade Notes**
146
147     - The Upgrade strategy for Frankfurt can be found here:`<https://wiki.onap.org/display/DW/Frankfurt+CLAMP+Container+upgrade+strategy>`_
148     - New Docker Containers are available. the list of containers composing this release are below:
149       - clamp-backend-filebeat-onap: docker.elastic.co/beats/filebeat 5.5.0
150       - clamp-backend: nexus3.onap.org:10001/onap/clamp-backend 5.0.6
151       - clamp-frontend: nexus3.onap.org:10001/onap/clamp-frontend 5.0.6
152       - clamp-dash-es: nexus3.onap.org:10001/onap/clamp-dashboard-elasticsearch 5.0.3
153       - clamp-dash-kibana: nexus3.onap.org:10001/onap/clamp-dashboard-kibana 5.0.3
154       - clamp-dash-logstash: nexus3.onap.org:10001/onap/clamp-dashboard-logstash 5.0.3
155
156
157 Version: 4.1.3 (El-Alto)
158 ------------------------
159
160 :Release Date: 2019-10-11
161
162 **New Features**
163
164 The El Alto release is the sixth release of the Control Loop Automation Management Platform (CLAMP).
165
166 The main goal of the El Alto release was to:
167
168     - _.Fix a maximum a security issues, especially the angular related issues by moving to React.
169
170 **Bug Fixes**
171
172         - The full list of implemented user stories and epics is available on `El Alto CLAMP user stories done <https://wiki.onap.org/display/DW/El+Alto+CLAMP+user+stories+done>`_
173           This includes the list of bugs that were fixed during the course of this release.
174
175 **Known Issues**
176
177     - `CLAMP-506 <https://jira.onap.org/browse/CLAMP-506>`_ Elastic Search Clamp image cannot be built anymore(SearchGuard DMCA issue)
178     - Due to the uncertainties with the DMCA SearchGuard issue, the ELK stack has been removed from El Alto release, meaning the CLAMP "Control Loop Dashboard" is not part of the El Alto release.
179     - `CLAMP-519 <https://jira.onap.org/browse/CLAMP-519>`_ Clamp cannot authenticate to AAF(Local authentication as workaround)
180
181
182 **Security Notes**
183
184 *Fixed Security Issues*
185
186 *Known Security Issues*
187
188 *Known Vulnerabilities in Used Modules*
189
190 CLAMP 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 actions to be taken in future release.
191 The CLAMP open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=68540334>`_.
192
193 Quick Links:
194         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
195
196         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
197
198         - `Project Vulnerability Review Table for CLAMP <https://wiki.onap.org/pages/viewpage.action?pageId=68540334>`_
199
200 **Upgrade Notes**
201
202     New Docker Containers are available.
203
204
205 Version: 4.1.0 (El-Alto Early Drop)
206 -----------------------------------
207
208 :Release Date: 2019-08-19
209
210 **New Features**
211
212 The El Alto-Early Drop release is the fifth release of the Control Loop Automation Management Platform (CLAMP).
213
214 The main goal of the El Alto-Early Drop release was to:
215
216     - _.Fix a maximum a security issues, especially the angular related issues by moving to React.
217
218 **Bug Fixes**
219
220         - The full list of implemented user stories and epics is available on `CLAMP R5 - Early Drop RELEASE <https://wiki.onap.org/display/DW/CLAMP+R5+-+Early+Drop>`_
221           This includes the list of bugs that were fixed during the course of this release.
222
223 **Known Issues**
224
225     - `CLAMP-384 <https://jira.onap.org/browse/CLAMP-384>`_ Loop State in UI is not reflecting the current state
226
227 **Security Notes**
228
229 *Fixed Security Issues*
230
231     - `OJSI-166 <https://jira.onap.org/browse/OJSI-166>`_ Port 30290 exposes unprotected service outside of cluster.
232
233 *Known Security Issues*
234
235 *Known Vulnerabilities in Used Modules*
236
237 CLAMP 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 actions to be taken in future release.
238 The CLAMP open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=68540334>`_.
239
240 Quick Links:
241         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
242
243         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
244
245         - `Project Vulnerability Review Table for CLAMP <https://wiki.onap.org/pages/viewpage.action?pageId=68540334>`_
246
247 **Upgrade Notes**
248
249     New Docker Containers are available.
250
251
252
253 Version: 4.0.5 (Dublin)
254 -----------------------
255
256 :Release Date: 2019-06-06
257
258 **New Features**
259
260 The Dublin release is the fourth release of the Control Loop Automation Management Platform (CLAMP).
261
262 The main goal of the Dublin release was to:
263
264     - Stabilize Platform maturity by stabilizing CLAMP maturity matrix see `Wiki <https://wiki.onap.org/display/DW/Dublin+Release+Platform+Maturity>`_.
265     - CLAMP supports of Policy-model based Configuration Policy
266     - CLAMP supports new Policy Engine direct Rest API (no longer based on jar provided by Policy Engine)
267     - CLAMP main Core/UI have been reworked, removal of security issues reported by Nexus IQ.
268
269 **Bug Fixes**
270
271         - The full list of implemented user stories and epics is available on `DUBLIN RELEASE <https://jira.onap.org/projects/CLAMP/versions/10427>`_
272           This includes the list of bugs that were fixed during the course of this release.
273
274 **Known Issues**
275
276     - `CLAMP-384 <https://jira.onap.org/browse/CLAMP-384>`_ Loop State in UI is not reflecting the current state
277
278 **Security Notes**
279
280 *Fixed Security Issues*
281
282     - `OJSI-128 <https://jira.onap.org/browse/OJSI-128>`_ In default deployment CLAMP (clamp) exposes HTTP port 30258 outside of cluster.
283     - `OJSI-147 <https://jira.onap.org/browse/OJSI-147>`_ In default deployment CLAMP (cdash-kibana) exposes HTTP port 30290 outside of cluster.
284     - `OJSI-152 <https://jira.onap.org/browse/OJSI-152>`_ In default deployment CLAMP (clamp) exposes HTTP port 30295 outside of cluster.
285
286 *Known Security Issues*
287
288 *Known Vulnerabilities in Used Modules*
289
290 CLAMP 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 actions to be taken in future release.
291 The CLAMP open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=64003444>`_.
292
293 Quick Links:
294         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
295
296         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
297
298         - `Project Vulnerability Review Table for CLAMP <https://wiki.onap.org/pages/viewpage.action?pageId=64003444>`_
299
300 **Upgrade Notes**
301
302     New Docker Containers are available.
303
304
305 Version: 3.0.4 - maintenance release
306 ------------------------------------
307
308 :Release Date: 2019-04-06
309
310 **New Features**
311 none
312
313 **Bug Fixes**
314 none
315
316 **Known Issues**
317 CLAMP certificates have been renewed to extend their expiry dates
318     - `CLAMP-335 <https://jira.onap.org/browse/CLAMP-335>`_ Update Certificates on Casablanca release.
319
320
321 Version: 3.0.3 - maintenance release
322 ------------------------------------
323
324 :Release Date: 2019-02-06
325
326 **New Features**
327 none
328
329 **Bug Fixes**
330 none
331
332 **Known Issues**
333 one documentation issue was fixed, this issue does not require a new docker image:
334     - `CLAMP-257 <https://jira.onap.org/browse/CLAMP-257>`_ User Manual for CLAMP : nothing on readthedocs.
335
336 Version: 3.0.3 (Casablanca)
337 ---------------------------
338
339 :Release Date: 2018-11-30
340
341 **New Features**
342
343 The Casablanca release is the third release of the Control Loop Automation Management Platform (CLAMP).
344
345 The main goal of the Casablanca release was to:
346
347     - Enhance Platform maturity by improving CLAMP maturity matrix see `Wiki <https://wiki.onap.org/display/DW/Casablanca+Release+Platform+Maturity>`_.
348     - CLAMP Dashboard improvements for the monitoring of active Closed Loops
349     - CLAMP logs alignment on the ONAP platform.
350     - CLAMP is now integrated with AAF for authentication and permissions retrieval (AAF server is pre-loaded by default with the required permissions)
351     - CLAMP improvement for configuring the policies (support of Scale Out use case)
352     - CLAMP main Core/UI have been reworked, removal of security issues reported by Nexus IQ on JAVA/JAVASCRIPT code (Libraries upgrade or removal/replacement when possible)
353     - As a POC, the javascript coverage can now be enabled in SONAR (Disabled for now)
354
355 **Bug Fixes**
356
357         - The full list of implemented user stories and epics is available on `CASABLANCA RELEASE <https://jira.onap.org/projects/CLAMP/versions/10408>`_
358           This includes the list of bugs that were fixed during the course of this release.
359
360 **Known Issues**
361
362     - None
363
364 **Security Notes**
365
366 CLAMP 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 actions to be taken in future release.
367 The CLAMP open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=42598587>`_.
368
369 Quick Links:
370         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
371
372         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
373
374         - `Project Vulnerability Review Table for CLAMP <https://wiki.onap.org/pages/viewpage.action?pageId=42598587>`_
375
376 **Upgrade Notes**
377
378     New Docker Containers are available, an ELK stack is also now part of CLAMP deployments.
379
380 **Deprecation Notes**
381
382     The CLAMP Designer Menu (in CLAMP UI) is deprecated since Beijing, the design time is being onboarded into SDC - DCAE D.
383
384 **Other**
385
386     CLAMP Dashboard is now implemented, allows to monitor Closed Loops that are running by retrieving CL events on DMAAP.
387
388 **How to - Videos**
389
390     https://wiki.onap.org/display/DW/CLAMP+videos
391
392 Version: 2.0.2 (Beijing)
393 ------------------------
394
395 :Release Date: 2018-06-07
396
397 **New Features**
398
399 The Beijing release is the second release of the Control Loop Automation Management Platform (CLAMP).
400
401 The main goal of the Beijing release was to:
402
403     - Enhance Platform maturity by improving CLAMP maturity matrix see `Wiki <https://wiki.onap.org/display/DW/Beijing+Release+Platform+Maturity>`_.
404     - Focus CLAMP on Closed loop runtime operations and control - this is reflected by the move of the design part to DCAE-D.
405     - Introduce CLAMP Dashboard for monitoring of active Closed Loops.
406     - CLAMP is integrated with MSB.
407     - CLAMP has integrated SWAGGER.
408     - CLAMP main Core has been reworked for improved flexibility.
409
410 **Bug Fixes**
411
412         - The full list of implemented user stories and epics is available on `BEIJING RELEASE <https://jira.onap.org/projects/CLAMP/versions/10314>`_
413           This includes the list of bugs that were fixed during the course of this release.
414
415 **Known Issues**
416
417     - `CLAMP-69 <https://jira.onap.org/browse/CLAMP-69>`_ Deploy action does not always work.
418
419         The "Deploy" action does not work directly after submitting it.
420
421         Workaround:
422
423         You have to close the CL and reopen it again. In that case the Deploy action will do something.
424
425 **Security Notes**
426
427 CLAMP 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 CLAMP open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=25440749>`_.
428
429 Quick Links:
430         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
431
432         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
433
434         - `Project Vulnerability Review Table for CLAMP <https://wiki.onap.org/pages/viewpage.action?pageId=25440749>`_
435
436 **Upgrade Notes**
437
438     New Docker Containers are avaialble, an ELK stack is also now part of CLAMP deployments.
439
440 **Deprecation Notes**
441
442     The CLAMP Designer UI is now deprecated and unavailable, the design time is being onboarded into SDC - DCAE D.
443
444 **Other**
445
446     CLAMP Dashboard is now implemented, allows to monitor Closed Loops that are running by retrieving CL events on DMAAP.
447
448 Version: 1.1.0 (Amsterdam)
449 --------------------------
450
451 :Release Date: 2017-11-16
452
453 **New Features**
454
455 The Amsterdam release is the first release of the Control Loop Automation Management Platform (CLAMP).
456
457 The main goal of the Amsterdam release was to:
458
459     - Support the automation of provisionning for the Closed loops of the vFW, vDNW and vCPE through TCA.
460     - Support the automation of provisionning for the Closed loops of VVolte (Holmes)
461     - Demonstrate complete interaction with Policy, DCAE, SDC and Holmes.
462
463 **Bug Fixes**
464
465         - The full list of implemented user stories and epics is available on `AMSTERDAM RELEASE <https://jira.onap.org/projects/CLAMP/versions/10313>`_
466           This is technically the first release of CLAMP, previous release was the seed code contribution.
467           As such, the defects fixed in this release were raised during the course of the release.
468           Anything not closed is captured below under Known Issues. If you want to review the defects fixed in the Amsterdam release, refer to Jira link above.
469
470 **Known Issues**
471         - `CLAMP-68 <https://jira.onap.org/browse/CLAMP-68>`_ ResourceVF not always provisioned.
472
473         In Closed Loop -> Properties CL: When opening the popup window, the first service in the list does not show Resource-VF even though in SDC there is a resource instance in the service.
474
475         Workaround:
476
477         If you have multiple service available (if not create a dummy one on SDC), just click on another one and then click back on the first one in the list. The ResourceVF should be provisioned now.
478
479     - `CLAMP-69 <https://jira.onap.org/browse/CLAMP-69>`_ Deploy action does not always work.
480
481         The "Deploy" action does not work directly after submitting it.
482
483         Workaround:
484
485         You have to close the CL and reopen it again. In that case the Deploy action will do something
486
487
488 **Security Issues**
489         CLAMP is following the CII Best Practices Badge Program, results including security assesment can be found on the
490         `project page <https://bestpractices.coreinfrastructure.org/projects/1197>`_
491
492
493 **Upgrade Notes**
494
495     N/A
496
497 **Deprecation Notes**
498
499     N/A
500
501 **Other**
502
503
504
505 ===========
506
507 End of Release Notes