Updated docs
[holmes/rule-management.git] / docs / docs / 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 .. _release_notes:
4
5
6 Holmes Rule Management Release Notes
7 ====================================
8
9 Holmes provides alarm correlation and analysis for telecom cloud infrastructure
10 and services, including hosts, vims, VNFs and NSs. Holmes aims to find the root
11 reason which causes the failure or degradation of services by digging into the
12 ocean of events collected from different levels of the telecom cloud.
13
14 Version: 9.0.1
15 --------------
16
17 :Release Date: 2021-10-28
18
19
20 **New Features**
21
22 N/A
23
24 **Bug Fixes**
25
26 - `Fixed Vulnerability issues by removing httpclient. <https://jira.onap.org/browse/HOLMES-441>`_
27 - `Failed to update rules if the package name does not end with a semicolon. <https://jira.onap.org/browse/HOLMES-482>`_
28 - `Database instantiation failed due to holmesdb password with single quote. <https://jira.onap.org/browse/HOLMES-463>`_
29 - `Existing rules are not able to sync when engine get restarted/redeployed. <https://jira.onap.org/browse/HOLMES-462>`_
30 - `RESTful APIs of the Engine Management Module are not Accessible. <https://jira.onap.org/browse/HOLMES-454>`_
31
32 **Known Issues**
33
34 - If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
35 - The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future.
36
37 **Security Issues**
38
39 HOLMES code has been formally scanned during build time using NexusCloud and all critical vulnerabilities have been addressed.
40
41 Quick Links:
42     - `HOLMES project page <https://wiki.onap.org/display/DW/Holmes+Project>`_
43
44     - `Passing Badge information for HOLMES <https://bestpractices.coreinfrastructure.org/en/projects/1602>`_
45
46
47 **Upgrade Notes**
48
49 N/A
50
51
52 **Deprecation Notes**
53
54 N/A
55
56
57 **Other**
58
59 N/A
60
61 Version: 8.0.1
62 --------------
63
64 :Release Date: 2021-04-22
65
66
67 **New Features**
68
69 - `HOLMES-380 <https://jira.onap.org/browse/HOLMES-380>`_ Migrate Holmes deployment to Helm
70
71 **Bug Fixes**
72
73 N/A
74
75 **Known Issues**
76
77 - If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
78 - The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future.
79
80 **Security Issues**
81
82 HOLMES code has been formally scanned during build time using NexusCloud and all critical vulnerabilities have been addressed.
83
84 Quick Links:
85     - `HOLMES project page <https://wiki.onap.org/display/DW/Holmes+Project>`_
86
87     - `Passing Badge information for HOLMES <https://bestpractices.coreinfrastructure.org/en/projects/1602>`_
88
89
90 **Upgrade Notes**
91
92 N/A
93
94
95 **Deprecation Notes**
96
97 N/A
98
99
100 **Other**
101
102 N/A
103
104
105 Version: 7.0.1
106 --------------
107
108 :Release Date: 2020-11-19
109
110
111 **New Features**
112
113 - `HOLMES-312 <https://jira.onap.org/browse/HOLMES-312>`_ Alarm Correlation Support in MDONS Close Loop
114
115 **Bug Fixes**
116
117 - `HOLMES-357 <https://jira.onap.org/browse/HOLMES-357>`_ Some holmes pods have no limit
118 - `HOLMES-367 <https://jira.onap.org/browse/HOLMES-367>`_ Holmes certificates are expired
119
120 **Known Issues**
121
122 - If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
123 - The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future.
124
125 **Security Issues**
126
127 HOLMES code has been formally scanned during build time using NexusCloud and all critical vulnerabilities have been addressed.
128
129 Quick Links:
130     - `HOLMES project page <https://wiki.onap.org/display/DW/Holmes+Project>`_
131
132     - `Passing Badge information for HOLMES <https://bestpractices.coreinfrastructure.org/en/projects/1602>`_
133
134
135 **Upgrade Notes**
136
137 - Upgraded the Java environment from Java 8 to Java 11.
138 - Changed the base images to onap/integration-java11:7.0.0.
139
140
141 **Deprecation Notes**
142
143 N/A
144
145
146 **Other**
147
148 N/A
149
150
151 Version: 5.0.1
152 --------------
153
154 :Release Date: 2019-10-17
155
156
157 **New Features**
158 N/A
159
160 **Bug Fixes**
161 N/A
162
163 **Known Issues**
164
165 - If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
166 - The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future.
167
168 **Security Issues**
169
170 HOLMES code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, some of the items that remain open have been assessed for risk and determined to be false positive and the rest are planned to be resolved in the next release.
171
172 Quick Links:
173     - `HOLMES project page <https://wiki.onap.org/display/DW/Holmes+Project>`_
174
175         - `Passing Badge information for HOLMES <https://bestpractices.coreinfrastructure.org/en/projects/1602>`_
176
177
178 **Upgrade Notes**
179
180 N/A
181
182
183 **Deprecation Notes**
184
185 N/A
186
187
188 **Other**
189
190 N/A
191
192 Version: 1.2.6
193 --------------
194
195 :Release Date: 2019-06-13
196
197
198 **New Features**
199 Added some tools to support the extended CCVPN use case:
200
201 - `Rules for CCVEN Extension <https://jira.onap.org/browse/HOLMES-193>`_ This feature provides some rules for the extended CCVPN usecase. Users could use the rules as templates to develop their own rules.
202 - `Updated AAI Assistant Tools for CCVPN Extension <https://jira.onap.org/browse/HOLMES-194>`_ Some tools related to the CCVPN usecase have been enhanced in order to support the extended CCVPN usecase.
203
204 **Bug Fixes**
205
206 - `HOLMES-204 <https://jira.onap.org/browse/HOLMES-204>`_ Alarms can not be deleted from the DB when they get cleared.
207 - `HOLMES-223 <https://jira.onap.org/browse/HOLMES-223>`_ The "ABATED" messages can not be generated in the control loop.
208
209 **Known Issues**
210
211 - If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
212 - The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future.
213
214 **Security Issues**
215
216 HOLMES code has been formally scanned during build time using NexusIQ and all Critical vulnerabilities have been addressed, some of the items that remain open have been assessed for risk and determined to be false positive and the rest are planned to be resolved in the next release.
217
218 Quick Links:
219     - `HOLMES project page <https://wiki.onap.org/display/DW/Holmes+Project>`_
220
221         - `Passing Badge information for HOLMES <https://bestpractices.coreinfrastructure.org/en/projects/1602>`_
222
223
224 **Upgrade Notes**
225
226 N/A
227
228
229 **Deprecation Notes**
230
231 N/A
232
233
234 **Other**
235
236 N/A
237
238 ===========
239
240 Version: 1.2.0
241 --------------
242
243 :Release Date: 2018-11-30
244
245
246 **New Features**
247 In the Casablanca release, Holmes provides its own GUI for rule management tasks:
248
249 - `UI Deployment <https://jira.onap.org/browse/HOLMES-96>`_ This feature provides a graphic user interface for the sake of easiness of rule management. It mainly provides a rule list view and a rule editing page. Users could get an overview of all rules that have been added to Holmes and create/modify them easily by using the GUI provided by this feature.
250
251 Besides, Holmes has been enhanced to be CCVPN use case supportive. CCVPN related assistant tools are added to the common library of Holmes.
252
253 **Bug Fixes**
254
255 - `HOLMES-156 <https://jira.onap.org/browse/HOLMES-156>`_ Rules can not be deployed after they've been added/removed from the engine.
256 - `HOLMES-133 <https://jira.onap.org/browse/HOLMES-133>`_ Don't rely on key word 'import' when extracting package name from rule.
257 - `HOLMES-130 <https://jira.onap.org/browse/HOLMES-130>`_ Holmes can not be successfully registered to MSB when trying to register itself with a health check parameter.
258
259 **Known Issues**
260
261 - If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
262 - The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future.
263
264 **Security Issues**
265
266 HOLMES 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 HOLMES open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=45298796>`_.
267
268 Quick Links:
269     - `HOLMES project page <https://wiki.onap.org/display/DW/Holmes+Project>`_
270
271         - `Passing Badge information for HOLMES <https://bestpractices.coreinfrastructure.org/en/projects/1602>`_
272
273         - `Project Vulnerability Review Table for HOLMES <https://wiki.onap.org/pages/viewpage.action?pageId=45298796>`_
274
275
276 **Upgrade Notes**
277
278 N/A
279
280
281 **Deprecation Notes**
282
283 N/A
284
285
286 **Other**
287
288 N/A
289
290 ===========
291
292
293 Version: 1.1.0
294 --------------
295
296 :Release Date: 2018-06-07
297
298
299 **New Features**
300 In the Beijing release, Holmes provides no more functionalites than the Amsterdam release. Its main features remains like follows:
301
302 - `Rule Management <https://jira.onap.org/browse/HOLMES-4>`_ The feature provides interfaces for the users to create, query, update and delete rules. In this release, they are used along with the DCAE interfaces to accomplish the deployment (creation/update) of the control loop related rules.
303
304 - `Engine Management <https://jira.onap.org/browse/HOLMES-5>`_ The feature is not exposed to the end user directly. It's mainly used internally by Holmes as a container for the execution of rules. It provides interface for rule verification and deployment/un-deployment.
305
306 Besides, Holmes has been enhanced to meet the platform maturity requirements. The enhancement mainly covers:
307
308 - Scaling: Holmes supports horizontal scale-in/scale-out operations in case it is overloaded by too large amounts of data.
309
310 - Security: Holmes has updated all its APIs to support the HTTPS protocol.
311
312 **Bug Fixes**
313
314 N/A
315
316 **Known Issues**
317
318 - If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
319 - The current horizontal scaling mechanism can not efficiently balance the load. Optimization is needed in the future.
320
321 **Security Issues**
322
323 HOLMES 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 HOLMES open Critical security vulnerabilities and their risk assessment have been documented as part of the `project <https://wiki.onap.org/pages/viewpage.action?pageId=28378012>`_.
324
325 Quick Links:
326     - `HOLMES project page <https://wiki.onap.org/display/DW/Holmes+Project>`_
327
328         - `Passing Badge information for HOLMES <https://bestpractices.coreinfrastructure.org/en/projects/1602>`_
329
330         - `Project Vulnerability Review Table for HOLMES <https://wiki.onap.org/pages/viewpage.action?pageId=28378012>`_
331
332
333 **Upgrade Notes**
334
335 - `HOLMES-99 <https://jira.onap.org/browse/HOLMES-99>`_ Updated the Drools engine to Version 6.5.0.
336 - `HOLMES-104 <https://jira.onap.org/browse/HOLMES-104>`_ Update all interfaces to enforce the HTTPS protocal.
337 - `HOLMES-112 <https://jira.onap.org/browse/HOLMES-112>`_ Following the guideline of the Logging Enhancements Project to implement log collection.
338 - `HOLMES-106 <https://jira.onap.org/browse/HOLMES-106>`_ Implemented horizontal scaling.
339 - `HOLMES-123 <https://jira.onap.org/browse/HOLMES-123>`_ Fixed some vulnerability issues identified by Nexus IQ.
340
341
342 **Deprecation Notes**
343
344 None of the HTTP APIs provided in the Amsterdam release are available in Beijing anymore.
345
346
347 **Other**
348
349 N/A
350
351 ===========
352
353 Version: 1.0.0
354 --------------
355
356 :Release Date: 2017-11-16
357
358
359 **New Features**
360 In the Amsterdam release, Holmes is mainly intended to support the alarm
361 correlation analysis for the VoLTE scenario. To get us there, Holmes provides
362 the following features:
363
364 - `Rule Management <https://jira.onap.org/browse/HOLMES-4>`_ The feature provides interfaces for the users to create, query, update and delete rules. In this release, they are used along with the DCAE interfaces to accomplish the deployment (creation/update) of the control loop related rules.
365
366 - `Engine Management <https://jira.onap.org/browse/HOLMES-5>`_ The feature is not exposed to the end user directly. It's mainly used internally by Holmes as a container for the execution of rules. It provides interface for rule verification and deployment/un-deployment.
367
368 **Bug Fixes**
369
370 This is the initial release.
371
372 **Known Issues**
373
374 If the database is not stable, there may be data/status inconsistency between the rule management module and the engine management module.
375
376 **Security Issues**
377
378 N/A
379
380 **Upgrade Notes**
381
382 N/A
383
384
385 End of Release Notes