ff27cc4526edb26b0cd69f62f7783240efb0b266
[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 in El Alto <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 (El Alto) <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 in El Alto Early Drop <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 (El Alto Early Drop) <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 for Dublin <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 in Dublin <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 (Dublin) <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
319     - `CLAMP-335 <https://jira.onap.org/browse/CLAMP-335>`_ Update Certificates on Casablanca release.
320
321
322 Version: 3.0.3 - maintenance release
323 ------------------------------------
324
325 :Release Date: 2019-02-06
326
327 **New Features**
328 none
329
330 **Bug Fixes**
331 none
332
333 **Known Issues**
334 one documentation issue was fixed, this issue does not require a new docker image:
335
336     - `CLAMP-257 <https://jira.onap.org/browse/CLAMP-257>`_ User Manual for CLAMP : nothing on readthedocs.
337
338 Version: 3.0.3 (Casablanca)
339 ---------------------------
340
341 :Release Date: 2018-11-30
342
343 **New Features**
344
345 The Casablanca release is the third release of the Control Loop Automation Management Platform (CLAMP).
346
347 The main goal of the Casablanca release was to:
348
349     - Enhance Platform maturity by improving CLAMP maturity matrix see `Wiki for Casablanca <https://wiki.onap.org/display/DW/Casablanca+Release+Platform+Maturity>`_.
350     - CLAMP Dashboard improvements for the monitoring of active Closed Loops
351     - CLAMP logs alignment on the ONAP platform.
352     - CLAMP is now integrated with AAF for authentication and permissions retrieval (AAF server is pre-loaded by default with the required permissions)
353     - CLAMP improvement for configuring the policies (support of Scale Out use case)
354     - 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)
355     - As a POC, the javascript coverage can now be enabled in SONAR (Disabled for now)
356
357 **Bug Fixes**
358
359         - The full list of implemented user stories and epics is available on `CASABLANCA RELEASE <https://jira.onap.org/projects/CLAMP/versions/10408>`_
360           This includes the list of bugs that were fixed during the course of this release.
361
362 **Known Issues**
363
364     - None
365
366 **Security Notes**
367
368 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.
369 The CLAMP open Critical security vulnerabilities and their risk assessment have been documented as part of the `project in Casablanca <https://wiki.onap.org/pages/viewpage.action?pageId=42598587>`_.
370
371 Quick Links:
372         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
373
374         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
375
376         - `Project Vulnerability Review Table for CLAMP in Casablanca <https://wiki.onap.org/pages/viewpage.action?pageId=42598587>`_
377
378 **Upgrade Notes**
379
380     New Docker Containers are available, an ELK stack is also now part of CLAMP deployments.
381
382 **Deprecation Notes**
383
384     The CLAMP Designer Menu (in CLAMP UI) is deprecated since Beijing, the design time is being onboarded into SDC - DCAE D.
385
386 **Other**
387
388     CLAMP Dashboard is now implemented, allows to monitor Closed Loops that are running by retrieving CL events on DMAAP.
389
390 **How to - Videos**
391
392     https://wiki.onap.org/display/DW/CLAMP+videos
393
394 Version: 2.0.2 (Beijing)
395 ------------------------
396
397 :Release Date: 2018-06-07
398
399 **New Features**
400
401 The Beijing release is the second release of the Control Loop Automation Management Platform (CLAMP).
402
403 The main goal of the Beijing release was to:
404
405     - Enhance Platform maturity by improving CLAMP maturity matrix see `Wiki for Beijing <https://wiki.onap.org/display/DW/Beijing+Release+Platform+Maturity>`_.
406     - Focus CLAMP on Closed loop runtime operations and control - this is reflected by the move of the design part to DCAE-D.
407     - Introduce CLAMP Dashboard for monitoring of active Closed Loops.
408     - CLAMP is integrated with MSB.
409     - CLAMP has integrated SWAGGER.
410     - CLAMP main Core has been reworked for improved flexibility.
411
412 **Bug Fixes**
413
414         - The full list of implemented user stories and epics is available on `BEIJING RELEASE <https://jira.onap.org/projects/CLAMP/versions/10314>`_
415           This includes the list of bugs that were fixed during the course of this release.
416
417 **Known Issues**
418
419     - `CLAMP-69 <https://jira.onap.org/browse/CLAMP-69>`_ Deploy action does not always work.
420
421         The "Deploy" action does not work directly after submitting it.
422
423         Workaround:
424
425         You have to close the CL and reopen it again. In that case the Deploy action will do something.
426
427 **Security Notes**
428
429 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 in Beijing <https://wiki.onap.org/pages/viewpage.action?pageId=25440749>`_.
430
431 Quick Links:
432         - `CLAMP project page <https://wiki.onap.org/display/DW/CLAMP+Project>`_
433
434         - `Passing Badge information for CLAMP <https://bestpractices.coreinfrastructure.org/en/projects/1197>`_
435
436         - `Project Vulnerability Review Table for CLAMP (Bejing) <https://wiki.onap.org/pages/viewpage.action?pageId=25440749>`_
437
438 **Upgrade Notes**
439
440     New Docker Containers are avaialble, an ELK stack is also now part of CLAMP deployments.
441
442 **Deprecation Notes**
443
444     The CLAMP Designer UI is now deprecated and unavailable, the design time is being onboarded into SDC - DCAE D.
445
446 **Other**
447
448     CLAMP Dashboard is now implemented, allows to monitor Closed Loops that are running by retrieving CL events on DMAAP.
449
450 Version: 1.1.0 (Amsterdam)
451 --------------------------
452
453 :Release Date: 2017-11-16
454
455 **New Features**
456
457 The Amsterdam release is the first release of the Control Loop Automation Management Platform (CLAMP).
458
459 The main goal of the Amsterdam release was to:
460
461     - Support the automation of provisionning for the Closed loops of the vFW, vDNW and vCPE through TCA.
462     - Support the automation of provisionning for the Closed loops of VVolte (Holmes)
463     - Demonstrate complete interaction with Policy, DCAE, SDC and Holmes.
464
465 **Bug Fixes**
466
467         - The full list of implemented user stories and epics is available on `AMSTERDAM RELEASE <https://jira.onap.org/projects/CLAMP/versions/10313>`_
468           This is technically the first release of CLAMP, previous release was the seed code contribution.
469           As such, the defects fixed in this release were raised during the course of the release.
470           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.
471
472 **Known Issues**
473         - `CLAMP-68 <https://jira.onap.org/browse/CLAMP-68>`_ ResourceVF not always provisioned.
474
475         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.
476
477         Workaround:
478
479         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.
480
481     - `CLAMP-69 <https://jira.onap.org/browse/CLAMP-69>`_ Deploy action does not always work.
482
483         The "Deploy" action does not work directly after submitting it.
484
485         Workaround:
486
487         You have to close the CL and reopen it again. In that case the Deploy action will do something
488
489
490 **Security Issues**
491         CLAMP is following the CII Best Practices Badge Program, results including security assesment can be found on the
492         `project page <https://bestpractices.coreinfrastructure.org/projects/1197>`_
493
494
495 **Upgrade Notes**
496
497     N/A
498
499 **Deprecation Notes**
500
501     N/A
502
503 **Other**
504
505
506
507 ===========
508
509 End of Release Notes